On 5/16/05, [EMAIL PROTECTED] <[EMAIL PROTECTED]> wrote: > Send Doc-SIG mailing list submissions to > [email protected] > > To subscribe or unsubscribe via the World Wide Web, visit > http://mail.python.org/mailman/listinfo/doc-sig > or, via email, send a message with subject or body 'help' to > [EMAIL PROTECTED] > > You can reach the person managing the list at > [EMAIL PROTECTED] > > When replying, please edit your Subject line so it is more specific > than "Re: Contents of Doc-SIG digest..." > > > Today's Topics: > > 1. Python docs in reST? (Skip Montanaro) > 2. Re: Python docs in reST? (Michael Foord) >
To me, the biggest single problem in Python documentation is that there is no standard inline documentation format which has been "blessed" as _the_ standard by the Python core development team. I like Python much better than Ruby, but take a look at Ruby for a an example of what kind of tools can be built once people have a standard as a base. rubydoc is really, really nice Whatever might be chosen or developed, we need IMHO a doc standard that is part of the core python package, and comes with all of the tools needed to use it. Without this, documentation of python modules is always going to be rather ad hoc. Not that this was useful, but in any case if anyone wants to work towards it... :-) Ken _______________________________________________ Doc-SIG maillist - [email protected] http://mail.python.org/mailman/listinfo/doc-sig
