[osiris-devel] Documentation Standard

[Thomas Jones]

Hello all,

I would like to see that all future/current documentation be standardized.

More precisely this is what I propose:

1) Written in Docbook XML
2) Encoding theme = ISO-8859-1
3) DocumentType Definition = kdex.dtd - Standard KDE Documentation
4) Public ID = //KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN

This affords the project a great magnitude of capabilities to process ALL 
documents efficiently. We can generate almost any format docs upon 
completion. It is easily updated to new standards. Any future translation can 
be done externally and applied with a simple argument.

This should provide the project with very nice, efficient documentation that 
"mirror" the efforts of other Open Source projects. Thus giving the end-user 
a more recognizable product.

Any ideas/comments?

Thomas