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

_______________________________________________
Doc-SIG maillist  -  Doc-SIG@python.org
http://mail.python.org/mailman/listinfo/doc-sig

Reply via email to