This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eric.araujo
Recipients adam.woodbeck, brett.cannon, docs@python, eric.araujo, ezio.melotti, fdrake, georg.brandl, rhettinger, sandro.tosi, tshepang
Date 2012-01-13.17:12:36
SpamBayes Score 0.0027973722
Marked as misclassified No
Message-id <1326474817.8.0.144200216803.issue12409@psf.upfronthosting.co.za>
In-reply-to
Content
About the devguide patch:

a) The part about C roles and directives should probably mention version specifics (:cmacro: for 2.7, :c:macro: for 3.x) — unless you make this bug dependent on updating Sphinx to 1.0 for 2.7 and then all versions use new-style :c:.

b) You probably want to use ref:documenting instead of :doc:documenting (we always use ref)

Not related to your patch, but it made me think about them so I’m just putting it out there for comments: Not sure we should keep the reST basics or just redirect to docutils and Sphinx docs.  Likewise, maybe it’s time to stop mentioning the old Latex-based docs.  (A nit: there are a few instances of `markup` that should be :file:`etc` or ``code``.)

About the cpython patch: You could just have said “rm Doc/documenting” :)  Georg, will you be the one to set up the docs.python.org redirects?
History
Date User Action Args
2012-01-13 17:13:37eric.araujosetrecipients: + eric.araujo, fdrake, brett.cannon, georg.brandl, rhettinger, ezio.melotti, sandro.tosi, docs@python, tshepang, adam.woodbeck
2012-01-13 17:13:37eric.araujosetmessageid: <1326474817.8.0.144200216803.issue12409@psf.upfronthosting.co.za>
2012-01-13 17:12:37eric.araujolinkissue12409 messages
2012-01-13 17:12:36eric.araujocreate