Fix wrongly indented blocks in the documentation

[ezio-melotti]

Bug report

In the documentation there are several blocks that are indented incorrectly but don't produce errors when the documentation is built. Two common mistakes wrap the misindented block into an additional blockquote or definition list, causing extra indentation in the rendered output but no other visible problems (at least with the current theme).

This is a follow-up of python/devguide#1178 and the linked PRs that fixed a list of similar issues in the devguide repository.

I'm working on a few PRs that fix these errors in the docs.

Linked PRs

• gh-110631: Fix reST indentation in Doc/whatsnew #110632
• [3.12] gh-110631: fix reST indentation in Doc/whatsnew (GH-110632) #110690
• [3.11] gh-110631: fix reST indentation in Doc/whatsnew (GH-110632) #110691
• gh-110631: Set three-space indents for reST in EditorConfig #110635
• [3.12] gh-110631: Set three-space indents for reST in EditorConfig (GH-110635) #110637
• [3.11] gh-110631: Set three-space indents for reST in EditorConfig (GH-110635) #110638
• gh-110631: Fix reST indentation in Doc/library #110685
• [3.12] gh-110631: Fix reST indentation in Doc/library (GH-110685) #110736
• [3.11] gh-110631: Fix reST indentation in Doc/library (GH-110685) #110737
• gh-110631: Fix reST indentation in Doc/reference #110708
• [3.12] gh-110631: Fix reST indentation in Doc/reference (GH-110708) #110740
• [3.11] gh-110631: Fix reST indentation in Doc/reference (GH-110708) #110741
• gh-110631: Fix reST indentation #110724
• [3.12] gh-110631: Fix reST indentation (GH-110724) #110738
• [3.11] gh-110631: Fix reST indentation (GH-110724) #110739
• gh-110631: Fix wrong reST markup and list numbers. #110885

[ezio-melotti]

All the issues should now be fixed, merged, and backported. The next step is adding the checker I wrote to detect these issues to sphinx-lint:

• Flag problematic uses of blockquote (with lists, blocks etc) sphinx-contrib/sphinx-lint#75

Thanks to @pradyunsg, @hugovk, and @AlexWaygood for helping me with this issue/PRs!