[x] confluence
I'd use confluence because: - documentation can be added on-the-fly - fixes to older documentation is not dependent on the release of the framework - the infrastructure is already there - more contributers could be allowed access to add documentation - comments by users on documentation pages could help you to find errors fast and others to get an alternative solution ...and jira's documentation is quite ok imho: http://confluence.atlassian.com/display/ALLDOC/JIRA+Documentation+Directory negative point is that everybody has to learn that confluence syntax and nobody likes writing documentation anyway... Howard, could I convince you a bit to decide for one solution? :) If you don't say "that's ok" nothing will move and people are waiting for proper documentation... My points from above have been discussed a lot of times on the list. Do you find another documentation system with the same benefits? Am 04.05.2010 um 18:52 schrieb Howard Lewis Ship: > I still don't have a strong opinion on this; I'm dissatisfied with > what we have now. > > On Sat, May 1, 2010 at 6:02 AM, Piero Sartini <[email protected]> wrote: >> We've discussed a lot about how documentation should be managed in the >> future. Now lets vote about what to do. >> Please note that this vote is about the future documentation system >> only, not about reworking the complete homepage. >> >> [ ] keep maven2 documentation as is, no need to change. >> [ ] re-organize documentation, but keep maven2 as generator (eg. move >> documentation to its own module) >> [ ] use textile to generate the documentation ( >> http://textile.thresholdstate.com ) >> [ ] make use of confluence ( >> https://cwiki.apache.org/TAPESTRY/tapestry-home.html ) > > +1 > > Basically, this is the only option that allows "many hands to make light > work". > >> >> Piero >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [email protected] >> For additional commands, e-mail: [email protected] >> >> > > > > -- > Howard M. Lewis Ship > > Creator of Apache Tapestry > > The source for Tapestry training, mentoring and support. Contact me to > learn how I can get you up and productive in Tapestry fast! > > (971) 678-5210 > http://howardlewisship.com > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
