On Tue, May 4, 2010 at 1:26 PM, Christian Riedel <[email protected]> wrote: > [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? >
I'm swinging towards Confluence, for all the reasons you've mentioned. > > 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] > > -- 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]
