René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Random walk documentation improvements","articleBody":"Across the documentation there are numerous examples of scope for improvement. Many of these could be described as housekeeping opportunities - documentation that is fundamentally sound, but needs to be updated and tidied up.\r\n\r\nAn example is [Porting Python 2 Code to Python 3](https://docs.python.org/3/howto/pyporting.html#porting-python-2-code-to-python-3), which was written in a different era.\r\n\r\nThese are the kind of thing that will be discovered in a random walk through the documentation, one thing leading to another. A random walk will also uncover (often small) possibilities for improvement that would otherwise likely hide unnoticed in quiet corners. \r\n\r\n# Pitch\r\n\r\nI propose taking a random walk through the documentation, finding and taking low-hanging fruit where I go. As well as the value of the fixes themselves, the activity and discussion of issues as they come up with bring further opportunities to the surface, and place them in front of more eyes.\r\n\r\n# Discoveries and suggestions\r\n\r\n- [ ] https://docs.python.org/3/howto/annotations.html is not really a how-to - it's an explanation-type document\r\n- [ ] https://docs.python.org/3/howto/functional.html should be moved to an explanation section\r\n- [ ] https://docs.python.org/3/howto/isolating-extensions.html is explanation\r\n\r\n\u003c!-- gh-linked-prs --\u003e\r\n### Linked PRs\r\n* gh-107434\r\n* gh-107445\r\n* gh-107449\r\n* gh-107654\n* gh-107655\n* gh-108409\n* gh-108410\n\u003c!-- /gh-linked-prs --\u003e","author":{"url":"https://github.com/evildmp","@type":"Person","name":"evildmp"},"datePublished":"2023-07-29T16:02:17.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/107432/cpython/issues/107432"}