Writing documentation with Maven

A poll has been started in the Maven Users List to know what format use the people to write their documentation (xdoc, html, docbook, latex or wiki).

Read the thread

Writting docbook project documentation.

These days I’m very busy writing a 150 pages document about ONess to be presented at the University of A Coruña (Spain). This doc is written in spanish and documents all the development process (eXtreme Programming based) of the ONess project till now.

I finally decided to use docbook as I found XMLMind editor (thanks Ben) that helps a lot writing docbook xml. I used Latex in previous projects but I don’t like it too much and xml is powerful and easier to transform.

To transform docbook xml to pdf I use a modified version of the maven sdocbook plugin. I also use a custom stylesheet to set fo parameters based on the one from Spring distribution, based in turn on the Hibernate one (thanks again Ben). Now I get a pretty pdf with correct margins, line spacing,…

I think it’s time to join efforts and create a maven plugin to generate pdf and html output from docbook so contributions are welcome.

Spring Framework 1.1 final released

The final 1.1 version has just been released and is available for Maven users in the central Maven repository (in no more than four hours).

I’m moving the news from the ONess project to this blog