Re: [Firebird-docs] Building new Firebird docs

[Robert (J. M. <rj...@ar...>]

Herman Timmermans wrote:

> Why not just writing the documentation in OpenOffice?
> It is open source, multi-platform, you can produce PDF and  RTF and DOC 
> formats as well, and the internal format is XML based (if I'm not 
> mistaking?)

Because it is way too flexible, and the documentation will end up in a 
big mess.

The documentation needs to be in a simple framework, with things like 
headings, SQL code snippets, other code snippets etc. identified clearly 
and consistently wherever they appear, so that when converting to other 
formats, they can remain consistent. Rules can then be enforced, like 
not having a title in the middle of a block of code. Diff and merge 
operations could be performed when people edit things, allowing 
different peoples ideas to be merged semi-automatically, which just 
couldn't be done with an office type package.

Robert Munro