Message319892
Right, my opinion is that we shouldn't be putting markup in docstrings. They are (from our point of view) pure text.
I don't know if discussion on python-dev is warranted, it seems like a fairly uncontroversial change, since it brings the docstrings in question into compliance with our general practice in the majority of the stdlib. Unless my impression about that is wrong :)
I don't have an opinion on multiple versus single PR for this. |
|
Date |
User |
Action |
Args |
2018-06-18 15:39:04 | r.david.murray | set | recipients:
+ r.david.murray, georg.brandl, terry.reedy, docs@python, lukasz.langa, Patrick Lehmann |
2018-06-18 15:39:04 | r.david.murray | set | messageid: <1529336344.37.0.56676864532.issue28710@psf.upfronthosting.co.za> |
2018-06-18 15:39:04 | r.david.murray | link | issue28710 messages |
2018-06-18 15:39:04 | r.david.murray | create | |
|