René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Improve the sqlite3 reference","articleBody":"Improve the sqlite3 reference, using [Diataxis as a guideline](https://diataxis.fr/reference/). A lot of work has already been done here, with great help from Alex Waygood and CAM Gerlach. PRs so far[^1] have focused on...:\r\n\r\n- [Be accurate](https://diataxis.fr/reference/#be-accurate)\r\n- [Do nothing but describe](https://diataxis.fr/reference/#do-nothing-but-describe); making the wording more to the point\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003ePrevious work over the last few years\u003c/summary\u003e\r\n\r\nBoth of these have been improved greatly by the following issues and PRs, amongst others:\r\n- gh-94630\r\n- gh-95235\r\n- gh-95235\r\n- gh-94940\r\n- gh-94321\r\n- gh-94628\r\n- gh-94017\r\n- gh-93890\r\n- gh-93925\r\n- gh-87260\r\n- gh-89018\r\n- gh-92780\r\n- gh-90923\r\n- gh-30660\r\n- gh-29326\r\n- gh-29200\r\n- gh-29219\r\n- gh-28238\r\n- gh-26220\r\n- gh-25003\r\n- gh-23159\r\n- gh-23965\r\n- consistency: gh-31772\r\n- consistency: gh-24746\r\n\r\n\u003c/details\u003e\r\n\r\nThere are remaining issues, though:\r\n\r\n- [x] Be accurate:\r\n    - #95379\r\n    - #95523\r\n    - #95530\r\n- [x] [Be consistent](https://diataxis.fr/reference/#be-consistent): Most of the reference docs for sqlite3 functions and methods use the imperative mood. Some of the methods use other wordings. Suggesting to normalise, and use the imperative mood across the reference section.\r\n  Improved with:\r\n    - #95274 \r\n    - #95525\r\n    - Remove duplicate links\r\n- [x] [Respect the structure of the machinery](https://diataxis.fr/reference/#respect-the-structure-of-the-machinery): Arrange the sections of reference to follow the architecture of the module. This is pretty good already, but I believe we may benefit from some adjustments, in particular:\r\n    - [x] Consistently group attributes and methods\r\n    - #95626\r\n    - #95430\r\n    - Align wording in function and method docstrings with documentation\r\n- [x] [Do nothing but describe](https://diataxis.fr/reference/#do-nothing-but-describe): Avoid digressions and discussions, or even better, extract them to separate sections. Remove and or simplify examples.\r\n    - #95351\r\n    - #95383\r\n    - gh-95840\r\n\r\n[^1]: There have been too many PRs to list; some of them were done before Diataxis was even discussed.","author":{"url":"https://github.com/erlend-aasland","@type":"Person","name":"erlend-aasland"},"datePublished":"2022-07-26T10:38:24.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/95273/cpython/issues/95273"}