API docs for user preferences

[brontolosone]

Towards #1211

I've hauled it through the sphinx circus to make sure it gets rendered.

[ktuite]

I feel like this shouldn't be a top level section of the Central API, but should be nested under the Accounts and Users section, probably after Users > initiating a password reset, and before the App Users subsection.

You could also mention this in the 2024.3 section of the changelog. There is already one bullet point there.

[brontolosone]

I feel like this shouldn't be a top level section of the Central API, but should be nested under the Accounts and Users section [...]

I thought about that at the time but thought it'd be better to follow the URL scheme. But yeah, the rest of the documentation doesn't do that always either. Fixed in e6a236e!

You could also mention this in the 2024.3 section of the changelog

What stopped me at the time was the Changelog subscript that says "Here major and breaking changes to the API are listed by version"; I didn't consider this API addition as major. Do you feel it's major?

[ktuite]

I have a few more minor requests but you can make those changes and go ahead and merge!

Do you feel it's major?

I think so! I mean, it's a whole new set of endpoints... now that the doors of a few user preferences have been opened, folks (like the QA team) are already starting to ask for more!

Even if it's targeted at ourselves, it would be useful to note it. I can see myself glancing through the changelog to remind myself when user preferences were added to the API.