Fix CI check-docs

[joverlee521]

Description of proposed changes

Regenerate the developer API documentation after creating a new venv
with Python 3.11 and installed the latest dependencies.

This will fix the CI/check-docs job, but seems very finicky from the
dev experience.

Related issue(s)

Resolves #1761

Checklist

• Automated checks pass
• Check if you need to add a changelog message
• Check if you need to add tests
• Check if you need to update docs

[genehack]

boy howdy that's a whole lotta churn

[corneliusroemer]

Thanks! IIUC this now orders the declarations alphabetically? So hopefully this won't change again later?

[joverlee521]

Merging for now since it'll fix CI.

The finicky dev experience I'm talking about is all dev's local environment must be using Python 3.11 + sphinx-autodoc-typehints v3.1.0 to keep the docs consistent when running devel/regenerate-developer-api-docs to regenerate the docs.

[jameshadfield]

Would it be a good idea to add checks for Python 3.11 + sphinx-autodoc-typehints v3.1.0 to devel/regenerate-developer-api-docs? I say this as someone who wasn't all that involved in the docs build-chain and finds all the moving parts quite a high barrier to full understanding. The more resilient and fool-proof we can be around docs the easier development on augur is for everyone.

[joverlee521]

We can continue discussion around docs development in #1764.