[Mailman-Developers] a question about documentation

[Barry Warsaw]

On Jun 2, 2009, at 12:51 AM, Terri Oda wrote:

> That said, I'm trying to keep the most recent documents in the wiki  
> now,  with the plan to eventually phase out the latex, so you may  
> wish to use the wiki as the source in the future.

This is a great plan, thanks Terri.  Note that wiki pages can be  
turned into PDF, IIRC. Any text based file system documentation we  
include going forward should probably be in restructured text (reST)  
format, since there are now excellent toolchains available to turn  
this into good printed and online documentation (Sphinx).  I think we  
can now claim reST is the standard documentation format for Python  
code.  All of MM3's doctests are in reST for example.

-Barry

-------------- next part --------------
A non-text attachment was scrubbed...
Name: PGP.sig
Type: application/pgp-signature
Size: 832 bytes
Desc: This is a digitally signed message part
URL: <http://mail.python.org/pipermail/mailman-developers/attachments/20090602/747c584c/attachment.pgp>