[<<] Industrie Toulouse

From the Zope 3 Dev mailing list this morning:

I hereby decree that Zope3 doc strings and text documentation files should be in reStructuredText format. Initially, this should apply to new doc strings and text documentation files, but we will convert old ones as need be or as time allows. [Jim Fulton, "FWIW: I endorse reStructuredText", zope3-dev, 5 Feb 2003]

This is great news. It should help the docutils mission to bring intelligent doc-strings to Python. And reStructuredText isthe best structure enhanced text design I've used yet. For most document writing needs, it does a great job. There's still a good size list of things to do, but nothing show-stopping. I've used reStructuredText as the format on two documentation efforts for customer projects and had far fewer problems than with... well, just about any other format out there. The project manager, David Goodger, pays close attention to stylistic details (meaning The Chicago Manual of Style), yielding excellent output.