[Sugar-devel] [FM Discuss] FM-->DocBook (was Fwd: Fwd: Documentation ...)

[Douglas Bagnall]

We discussed Docbook quite a bit in March and made one or two limp
attempts at conversion.  For example:

http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/2009-March/001157.html

There are just two things preventing us from offering automatically
generated docbook:

1. Nobody has come up with a concrete enough need for it to even say
what good FM docbook would look like (until now?).

2. The source is html written by over 700 people using a mix of wysiwyg
editors, twiki markup, hand coding, and cut-and-paste from word processors.

It would be easier to concentrate on the first problem.  We won't know
if the books' source needs a manual clean-up until it is shown to be
broken.

Douglas