I agree with this, XML looks ideal. I think this is the area I'd like to get involved
TASK 1c:
Determine a schema describing the fields/elements of the documentation,
in order for the docs to be databased & later sliced in a variety of
ways (beginner manual, advanced specs, test cases, etc.) Input and/or
output requirements are, at minimum:
-- as XML
-- as HTML
-- as manpage (*roff)
-- as PDF
-- as LaTex
-- as POD
-- as executable test cases
Note that POD consists of formatting directives, not schema information,
and so cannot represent the information in a form sufficient for full
slicing. At this point it would therefore appear that XML is the most
obvious authoring option.
in for now.
R.
