I experienced docbook to publish MyBatis (formerly Apache iBATIS) manuals (both pdf/html sites) and to generate them on my local machine (2.3 GHz Intel Core i5, 4Gb 1333 MHz DDR3) required a laaaaaaaaarge amount of time, so we migrated to Maven xdoc and reduced that time in minutes.
And yes, it was part of the build via Maven plugin. My 0.02 cents, -Simo http://people.apache.org/~simonetripodi/ http://simonetripodi.livejournal.com/ http://twitter.com/simonetripodi http://www.99soft.org/ On Mon, Oct 8, 2012 at 3:07 PM, Raffaele P. Guidi <[email protected]> wrote: > I agree but docbook and his toolsuite helps organizing ideas in a > consistent reference document (well, a book). That should be differently > organized than the site itself. See spring or hibernate or, if you want to > stay closer to home, apache velocity documentation. They all use docbook > and have great docs (not a cohincidence IMHO). > > Regards, > Raffaele > Il giorno 08/ott/2012 14:09, "Olivier Lamy" <[email protected]> ha scritto: > >> could that be integrated in a maven site build ? Is there any maven >> plugin for docbook ? >> Because for javadoc maven is helpfull and well integrated for >> deployment to directmemory.a.o >> >> And IMHO the most important is to write doc (not discussing on the >> tool to do it :P ) >> >> 2012/10/8 Raffaele P. Guidi <[email protected]>: >> > Yeah I know, I'm proposing a change as I'm not 100% satisfied with it and >> > Docbook really helps in building consistent documentation. >> > >> > What do you think about it? >> > >> > Ciao, >> > R >> > Il giorno 08/ott/2012 11:35, "Simone Tripodi" <[email protected]> >> ha >> > scritto: >> > >> >> Good morning, >> >> >> >> to publish documentation like the one on >> >> http://directmemory.apache.org/ we used APT and xdoc Maven's format, >> >> not docbook. >> >> >> >> best, >> >> -Simo >> >> >> >> http://people.apache.org/~simonetripodi/ >> >> http://simonetripodi.livejournal.com/ >> >> http://twitter.com/simonetripodi >> >> http://www.99soft.org/ >> >> >> >> >> >> On Sat, Oct 6, 2012 at 10:40 PM, Christoph Engelbert >> >> <[email protected]> wrote: >> >> > I worked with the docbook standard in a company before. It worked >> >> > very well for documentation of an SOAP webservice and was >> >> > "relatively" easy to customize in terms of layouts. >> >> > >> >> > So +1 from me for using docbook to create pdf and html from the >> >> > docbook standard xml. >> >> > >> >> > I found a really good xml editor with direct docbook support, just >> >> > need to search for it again :-) >> >> > >> >> > Cheers Chris >> >> > >> >> > Am 06.10.2012 22:36, schrieb Raffaele P. Guidi: >> >> >> Yep, it was docbook. I think it brings to extremely well done >> >> >> documentation. Do you guys think that it could be worth giving it a >> try? >> >> >> >> >> >> Ciao, >> >> >> R >> >> >> >> >> >> On Sat, Oct 6, 2012 at 10:24 PM, Raffaele P. Guidi < >> >> >> [email protected]> wrote: >> >> >> >> >> >>> You are welcome, thanks for getting involved :) of course adding >> docs >> >> to >> >> >>> the DM maven site is the preferred way even though I wouldn't say >> that >> >> we >> >> >>> are an excellence, when it comes to docs and probably an easier way >> to >> >> >>> write them would help. Has anyone proposals about it? I really like >> >> how the >> >> >>> spring framework is documented (I think it's done with a lucene >> tool, >> >> don't >> >> >>> remember exactly how it is called and my google karma tonight is >> low). >> >> >>> >> >> >>> Ciao, >> >> >>> R >> >> >>> >> >> >>> >> >> >>> On Sat, Oct 6, 2012 at 9:47 PM, Christoph Engelbert < >> >> [email protected]>wrote: >> >> >>> >> >> >>>> Hey guys, >> >> >>>> >> >> >>>> so the account creation was successful :-) Thanks for the given >> >> >>>> trust I'm totally proud. >> >> >>>> >> >> >>>> The first question is how to do documentation for Lightning? Is >> >> >>>> there a preferred way to document subprojects or do they get there >> >> >>>> own part on the main projects page (like it seems to be on the >> >> >>>> commons projects)? >> >> >>>> >> >> >>>> Cheers Chris >> >> >>>> >> >> >>> >> >> > >> >> >> >> >> >> -- >> Olivier Lamy >> Talend: http://coders.talend.com >> http://twitter.com/olamy | http://linkedin.com/in/olamy >>
