Gianluca Sforna | 31 Jan 00:06
Gravatar

DocBook manual

Hi everybody,
In the last few weeks I worked on converting the mantis manual from
HTML to DocBook format.

This is the first step of a process with the following goals:

1. have a single, versioned source for HTML and PDF manuals
2. keep the manual more up to date with new features
3. allow translators to provide localized documentation

The requirements we identified so far are:
* we want to tag/branch manual+sources at the same time
* we want a single location for all the translations
* we do not want to force downloading manual for just working on the
code, and vice versa

To support all of the above, I think we need a major reorganization of
the repository; something like:

ROOT=http://mantisbt.svn.sourceforge.net/viewvc/mantisbt/trunk

$ROOT/sources
$ROOT/sources/mantis  << actual source code
$ROOT/sources/manual
$ROOT/sources/manual/$LANG  << one of these for each language

Questions, comments or alternative ideas on the topic are very welcome

Cheers

Gianluca

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/

Gmane