[Doc-SIG] what about OpenDocument?

Chad Whitacre chad at zetaweb.com
Fri Dec 30 15:03:49 CET 2005


Dear all,

Here's a crazy idea: what would it look like to maintain the Python 
documentation in OpenDocument format?


Pros
====

   - robust authoring environment: OpenOffice
   - drastically lower barrier to entry for authors
   - custom markup == custom OOo stylesheet (!)
   - open XML-based format means easy-to-write tools
   - trivial PDF conversion
   - powerful typesetting
   - nice boost for ODF/OOo


Cons
====

   - HTML version would take work; default not good enough
   - harder to diff/version?
   - um ..., um ...


"Hey, I'd like to write documentation for my new Python module."
"Ok, download the OOo template from python.org and go to it!"




chad



More information about the Doc-SIG mailing list