Closed
Description
Users who don't have a github login are instructed to report issues to docs@python.org.
I meant to do some triaging before converting the mails to GH issues, but always had something more important to do. So I'm posting a rough list to get more eyes on these. Each has a link to the list post.
(These weren't triaged; they're not necessarily good ideas.)
### Tasks
- [x] typo in socket docs -- [Hank Knox](https://mail.python.org/archives/list/docs@python.org/thread/T7BAG3ROH3YT3YTAWCUE7CMZ2FI6VO72/)
- [x] asyncio shield typo -- [Dyussenov Nuraly](https://mail.python.org/archives/list/docs@python.org/thread/6EM4DHHS3RMWSJWV2ZGKWTJRD4Z2GNIC/) - (https://github.com/python/cpython/pull/108427)
- [x] array -- data type range printed wrong -- [Shivansh Verma](https://mail.python.org/archives/list/docs@python.org/thread/B463UYLY2RBIG66LXM3TIPZDZIYWCN6X/) (#113708)
- [ ] EPUB error -- e.g. [Glenn Street](https://mail.python.org/archives/list/docs@python.org/thread/HSIILYH7LVK4JU5U5GWHHIP4PU34UTNN/), [Ranjith B](https://mail.python.org/archives/list/docs@python.org/thread/Y3K22WC7QQVIECZBLFZPYYFWOCAOPZ2K/), [sobi](https://mail.python.org/archives/list/docs@python.org/message/JELSGFZ6HC2SKHPHTX3LSGH627QVGE5N/)
- [x] Howto/regex omits the simplest {n} case -- [Derek Mead](https://mail.python.org/archives/list/docs@python.org/thread/7D56UZ3VSWCQVQPIL44LWTO42EJUBRKI/) -- (https://github.com/python/cpython/pull/111110)
- [x] Problem in help for str().rsplit() -- [Alan Brogan](https://mail.python.org/archives/list/docs@python.org/thread/MCSKKTHBKX6AIK25YI2INEDVONJZYRLH/) - (https://github.com/python/cpython/pull/113355)
- [x] replacement for deprecation -- [SUN Guonian](https://mail.python.org/archives/list/docs@python.org/thread/4AYZNSW3RB3DNT5C7JEE6RCESBWIKZTD/) (https://github.com/python/cpython/pull/112783)
- [x] Potential typo in Profiler docs? -- [2dfkit](https://mail.python.org/archives/list/docs@python.org/thread/DJNXVVP2UW4R6OAPRA6TE5WMHDC4NKZ6/)
- [x] timeit -- [Arthur Goldberg](https://mail.python.org/archives/list/docs@python.org/thread/CQON3MGDEN6CY5KFXXBY4FTCG2FIIDTM/) -- (GH-110407)
- [x] list of errata: 1 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/)
- [x] list of errata: 2 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (https://github.com/python/cpython/pull/119330)
- [x] list of errata: 3 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (https://github.com/python/cpython/pull/112777)
- [x] list of errata: 4 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) - WONTFIX
- [x] list of errata: 5 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) - WONTFIX
- [x] list of errata: 6 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (#120219)
- [x] list of errata: 7 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/)
- [x] list of errata: 8 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/) -- (https://github.com/python/cpython/pull/111574)
- [x] list of errata: 9 -- [Stephan Stiller](https://mail.python.org/archives/list/docs@python.org/thread/ZEDPZHRVGLYR4ZFZ5I3NBWVMHMX4WPGW/)
- [x] profiler docs inaccuracy -- [2dfkit](https://mail.python.org/archives/list/docs@python.org/thread/DJNXVVP2UW4R6OAPRA6TE5WMHDC4NKZ6/#DJNXVVP2UW4R6OAPRA6TE5WMHDC4NKZ6) -- (https://github.com/python/cpython/pull/112221)
- [ ] https://github.com/python/cpython/issues/112146
- [x] Getting tkinter -- [Steve Philcox](https://mail.python.org/archives/list/docs@python.org/message/JOQ3RQVG3A7ZYOWEVU7TAYLY2WSZ6TST/): This complaint is about how to install dependencies when building CPython; this is already covered by the devguide.
- [ ] https://github.com/python/cpython/issues/120302
- [x] Problems in Python tutorial -- [Todd Hoatson](https://mail.python.org/archives/list/docs@python.org/message/REO4QRDIHU5ML4BMNXPDONCKONIH6RN3/)
- [x] link from UserList docs to the collections classes list of methods -- [Seebs](https://mail.python.org/archives/list/docs@python.org/message/37ZRBCHCB37Y2KW73EBHXFGRIZHFCNUU/) - WONTFIX
- [x] confusing formatting of “`field`s” -- [Роман Филимонов](https://mail.python.org/archives/list/docs@python.org/message/G5AYM2N4LLB65BTPQZBX5BIMBXRGUPVP/): this is a common way of marking up the plural variant of something that's marked up using a monospaced font; not a bug
- [x] socket.makefile -- [Michael Gold](https://mail.python.org/archives/list/docs@python.org/thread/3VGLA6Q6QDYB7XIAHFIRAVW4TQSEAZGA/)
- [x] `pow` - “integral” is confusing to non-natives -- [marc rovira](https://mail.python.org/archives/list/docs@python.org/thread/HD47WPHMLKUTQEWEQOHBAGULUHN4ICPQ/) -- (https://github.com/python/cpython/pull/119688)
Feel free to tick off ones that aren't appropriate, and convert larger ones to their own issues.
Linked PRs
- gh-110383 TimeIt Docs Spelling Fix #110407
- [3.12] gh-110383 TimeIt Docs Spelling Fix (GH-110407) #110409
- [3.11] gh-110383 TimeIt Docs Spelling Fix (GH-110407) #110410
- gh-110383: Swap 'the all' -> 'all the' in socket docs #110434
- [3.12] gh-110383: Swap 'the all' -> 'all the' in socket docs (GH-110434) #110435
- [3.11] gh-110383: Swap 'the all' -> 'all the' in socket docs (GH-110434) #110436
- gh-110383: Array module docs fix #111018
- gh-110383: Added explanation about simplest regex use case for quantifiers. #111110
- [3.12] gh-110383: Added explanation about simplest regex use case for quantifiers. (GH-111110) #111204
- [3.11] gh-110383: Added explanation about simplest regex use case for quantifiers. (GH-111110) #111205
- gh-110383: Italicize variable name #111206
- [3.12] gh-110383: Italicize variable name (GH-111206) #111207
- [3.11] gh-110383: Italicize variable name (GH-111206) #111208
- gh-110383: Changed the doc for str.rsplit from 'starting from the left' to 'starting from the right' #111247
- gh-110383: Fix documentation profile cumtime fix #112221
- [3.12] gh-110383: Fix documentation profile cumtime fix (GH-112221) #112262
- [3.11] gh-110383: Fix documentation profile cumtime fix (GH-112221) #112263
- gh-110383: Explained which error message is generated when there is an unhandled exception #111574
- [3.12] gh-110383: Explained which error message is generated when there is an unhandled exception (GH-111574) #112264
- [3.11] gh-110383: Explained which error message is generated when there is an unhandled exception (GH-111574) #112265
- gh-110383: Add documentation entry for
sorted(d)#112777 - gh-110383: Remove references to removed popen[234] #112783
- gh-110383: Fix docstring for str.rsplit maxsplit param to 'starting from the right' #113353
- gh-110383: Improve accuracy of str.split() and str.rsplit() docstrings #113355
- [3.12] gh-110383: Improve accuracy of str.split() and str.rsplit() docstrings (GH-113355) #113379
- [3.11] gh-110383: Improve accuracy of str.split() and str.rsplit() docstrings (GH-113355) #113380
- gh-110383: Added explanation in Doc about array data types range. Based on GNU docs #113708
- gh-110383: Fix problems in Python Input and Output tutorial #118970
- gh-110383: Document
socket.makefile()accepts combined modes #119150 - GH-110383: Improve Tutorial for Input Ouput #119230
- [3.13] gh-110383: Document
socket.makefile()accepts combined modes (GH-119150) #119324 - [3.12] gh-110383: Document
socket.makefile()accepts combined modes (GH-119150) #119325 - [3.13] GH-110383: Improve Tutorial for Input Ouput (GH-119230) #119326
- [3.12] GH-110383: Improve Tutorial for Input Ouput (GH-119230) #119327
- gh-110383: Update dict
get,fromkeys, andsetdefaultsignatures in docs #119330 - [3.13] gh-110383: Align dict.get(), .fromkeys(), and .setdefault() docs with docstrings (GH-119330) #119370
- [3.12] gh-110383: Align dict.get(), .fromkeys(), and .setdefault() docs with docstrings (GH-119330) #119371
- gh-110383: Clarify "non-integral" wording in pow() docs #119688
- [3.13] gh-110383: Clarify "non-integral" wording in pow() docs (GH-119688) #120206
- [3.12] gh-110383: Clarify "non-integral" wording in pow() docs (GH-119688) #120207
- gh-110383: Improve 'old string formatting' text in tutorial #120219
- [3.13] gh-110383: Improve 'old string formatting' text in tutorial (GH-120219) #120229
- [3.12] gh-110383: Improve 'old string formatting' text in tutorial (GH-120219) #120230