Documentation of pathlib.Path methods is disorganised

[barneygale]

Documentation

The docs for pathlib.Path methods is disorganised. It was originally alphabetical, but over the last few years we've begun moving similar methods together. We ought to split it up into sections, to make it easier to navigate and absorb, e.g.:

• Parsing and generating URIs
• Querying file type and status
• Reading and writing files
• Iterating over directories
• Making paths absolute
• Expanding home directories
• Resolving symlinks
• Permissions
• Ownership
• Other methods

If this granularity is too fine, we could stick more stuff in "Other methods".

Linked PRs

• GH-119054: Add "Querying file type and status" section to pathlib docs #119055
• GH-119054: Add "Reading and writing files" section to pathlib docs #119524
• [3.13] GH-119054: Add "Querying file type and status" section to pathlib docs (GH-119055) #119951
• [3.12] GH-119054: Add "Querying file type and status" section to pathlib docs (GH-119055) #119952
• [3.13] GH-119054: Add "Reading and writing files" section to pathlib docs (GH-119524) #119954
• [3.12] GH-119054: Add "Reading and writing files" section to pathlib docs (GH-119524) #119955
• GH-119054: Add "Reading directories" section to pathlib docs #119956
• [3.13] GH-119054: Add "Reading directories" section to pathlib docs (GH-119956) #120183
• [3.12] GH-119054: Add "Reading directories" section to pathlib docs (GH-119956) #120184
• GH-119054: Add "Creating files and directories" section to pathlib docs. #120186
• [3.13] GH-119054: Add "Creating files and directories" section to pathlib docs. (GH-120186) #120462
• [3.12] GH-119054: Add "Creating files and directories" section to pathlib docs. (GH-120186) #120464
• GH-119054: Add "Renaming and deleting" section to pathlib docs. #120465
• [3.13] GH-119054: Add "Renaming and deleting" section to pathlib docs. (GH-120465) #120472
• [3.12] GH-119054: Add "Renaming and deleting" section to pathlib docs. (GH-120465) #120473
• GH-119054: Add "Permissions and ownership" section to pathlib docs. #120505
• [3.13] GH-119054: Add "Permissions and ownership" section to pathlib docs. (GH-120505) #120967
• [3.12] GH-119054: Add "Permissions and ownership" section to pathlib docs. (GH-120505) #120968
• GH-119054: Add "Expanding and resolving paths" section to pathlib docs. #120970
• [3.13] GH-119054: Add "Expanding and resolving paths" section to pathlib docs. (GH-120970) #121155
• [3.12] GH-119054: Add "Expanding and resolving paths" section to pathlib docs. (GH-120970) #121156
• GH-119054: Add alt text to pathlib inheritance diagram #121158
• [3.12] GH-119054: Fix pathlib docs subtitle word order #121167
• [3.13] GH-119054: Add alt text to pathlib inheritance diagram (GH-121158) #121168
• [3.12] GH-119054: Add alt text to pathlib inheritance diagram (GH-121158) #121169

[barneygale]

It's finished! Thank you for all the reviews :)