Message 319907 - Python tracker

Message319907

Author terry.reedy
Recipients Patrick Lehmann, docs@python, georg.brandl, lukasz.langa, r.david.murray, serhiy.storchaka, terry.reedy
Date 2018-06-18.19:37:03
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1529350623.24.0.56676864532.issue28710@psf.upfronthosting.co.za>
In-reply-to
Content
RestructuredText, DocUtils, and Sphinx were developed independently, by people other than the pydev/cpython group.  (The proposal to include DocUtils in the stdlib was rejected.)  We converted to .rst for the Python documentation sources files about a decade ago.  Sphinx turns them into the .html files you can see online.  RestructuredText markup can now also be used in PEP, news/changelog, and What's New sources.  These are things that most people only view online or in other processed forms, not in source form.

On the other hand, stdlib docstrings are mostly viewed unprocessed in .py sources or as output from help() in text consoles or text widgets.  So markup in stdlib docstrings would impact everyone, not just core developers.
History
Date User Action Args
2018-06-18 19:37:03terry.reedysetrecipients: + terry.reedy, georg.brandl, r.david.murray, docs@python, lukasz.langa, serhiy.storchaka, Patrick Lehmann
2018-06-18 19:37:03terry.reedysetmessageid: <1529350623.24.0.56676864532.issue28710@psf.upfronthosting.co.za>
2018-06-18 19:37:03terry.reedylinkissue28710 messages
2018-06-18 19:37:03terry.reedycreate