gh-94635: Normalise sqlite3 doc headings

[erlend-aasland]

Fixes #94635

[CAM-Gerlach]

• Per the devguide,

  In the Python documentation, the use of sentence case in section titles is preferable, but consistency within a unit is more important than following this rule. If you add a section to a chapter where most sections are in title case, you can either convert all titles to sentence case or use the dominant style in the new section title.

  Since around half or more of the tiles are already sentence case, if we're going to change it, it makes sense to do so to the preferred style.

• I'm not sure adding the "How to" prefix is necessary on titles that already are framed as tasks, since it is somewhat redundant and repetitive, especially if/when the supersection title is changed to "How-to"—it is inherent than sections directly underneath a "How to" section describe "How to" do something.

• While you're at it and touching these anyway, you could normalize it to use the standard heading levels in the devguide—basically, just moving everything up a level, IIUC. But that's strictly optional, of course.

Other than that, this seems okay, assuming the plan is to move "Default Adapters and Converters" and "Adapter and Converter Recipes", etc., under their appropriate "How-to" sections ("Adapt..." and "Convert...") in the followup PR.

Thanks!

[erlend-aasland]

While you're at it and touching these anyway, you could normalize it to use the standard heading levels in the devguide—basically, just moving everything up a level, IIUC. But that's strictly optional, of course.

I'm planning to address that in a separate PR. Let's do the headings first; I want these doc PRs to be concise.

[erlend-aasland]

I'm not sure adding the "How to" prefix is necessary on titles that already are framed as tasks, since it is somewhat redundant and repetitive, especially if/when the supersection title is changed to "How-to"—it is inherent than sections directly underneath a "How to" section describe "How to" do something.

Absolutely, but Diátaxis explicitly recommends such headings: https://diataxis.fr/how-to-guides/#pay-attention-to-naming

[erlend-aasland]

Regarding the "How to" prefix; perhaps we should put this PR on hold until we're through the Diátaxis workshop in August. There is no hurry to get this done anyways.

[CAM-Gerlach]

Absolutely, but Diátaxis explicitly recommends such headings: diataxis.fr/how-to-guides/#pay-attention-to-naming

Right, but that's for top-level page titles, and the section headings would still be worded in task-oriented "how to" form (e.g. "(How to) adapt Python types to custom SQLite values", rather than the proscribed "Adapting Python types to custom SQLite values" or "Python-SQLite type conversion", with the "How to" wording as the top-level parent section, just not also repeated again in every sub-section title underneath it.

[erlend-aasland]

I guess you're right; that makes sense. I'd still like to put this on hold until after the workshop.

[erlend-aasland]

Here's how Django has organised their How To chapter:

https://docs.djangoproject.com/en/4.0/howto/

[erlend-aasland]

Closing this, as most of the work has been done in other PR's. If we need to tweak headings, we can do so on a case-by-case basis.