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]
