I don't think it needs to be either/or approach. The current APT-based reference documentation is of good quality, I think most people can agree with that. The principal issue is people feel the current documentation needs to be supplemented with more official tutorials and user guides that, in my opinion, are easier to write with some Wiki-based system such as Confluence since they generally take lots of edits and input from multiple people to get it right.
Kalle On Wed, May 5, 2010 at 12:32 AM, Massimo Lusetti <[email protected]> wrote: > On Wed, May 5, 2010 at 8:30 AM, Igor Drobiazko <[email protected]> > wrote: > >> I don't like wiki-based documentation because of their proprietary formats. >> Furthermore you have to be online to access it. I believe we need an >> appealing home page for basic stuff like introduction, short getting started >> etc. The user guide / reference should be written in Docbook. Spring and >> Hibernate guys proved that this is the way to provide a good documentation. >> The documentation should be downloadable. > > Again today I agree with you. > > As I already stated I don't hate apt that much but I don't even write > Tapestry docs. Having said that using Docbook or Maven APT is > basically the same and a matter of taste to some degree, I would > definetly go for a solution where I can have the docs on my offline > PCs or have a printable copy maybe relative to a stable release. > > So from switching to Confluence and stick with Maven apt I'll choose the > latter. > > Cheers > -- > Massimo > http://meridio.blogspot.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]
