Finalize sphinx documentation practice
This page represents the current plan; for discussion please check the tracker link above.
This proposal outlines a process for generating and managing project documentation with Sphinx.
Documentation will be organized into three categories:
#. user guide
#. developer guide
#. web site
And reorganized in svn as follows:
trunk/ docs/ devel/ user/ web/ modules/ ...
The maven build will be updated to build documentation. This will involve having maven invoke the sphinx-build utility (through ant). With this building documentation will be no different than building a regular module.
The assembly process that produces the bin and src artifacts will be updated. A third assembly will be added for the user guide. And potentially a fourth for the developer guide.
The hudson server will be updated to build docs continuously in the same manner the rest of the code base is built when changes occur. On successful builds the latest version of the documentation will be published.
Docs currently living in
web will be separated and moved into