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 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