Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Remove sphinx_autodoc_typehints #1603

Merged
merged 1 commit into from
Jan 4, 2025

Conversation

trevorbaca
Copy link
Member

sphinx_autodoc_typehints has had some long-running bugs related to the reST container directive.

The current bug is ...

https://github.com/tox-dev/sphinx-autodoc-typehints/issues/513

... which mangles the formatting of docstrings that have a return-type annotation and a container directive.

This commit removes sphinx_autodoc_typethints. This prevents several dozen errors and warnings when Sphinx builds.

The extension doesn't look like it was providing much value to the docs anyway. Sphinx adds type annotations without sphinx_autodoc_typehints.

sphinx_autodoc_typehints has had some long-running bugs related
to the reST `container` directive.

The current bug is ...

    tox-dev/sphinx-autodoc-typehints#513

... which mangles the formatting of docstrings that have a return-type
annotation and a `container` directive.

This commit removes sphinx_autodoc_typethints. This prevents
several dozen errors and warnings when Sphinx builds.

The extension doesn't look like it was providing much value to the docs
anyway. Sphinx adds type annotations without sphinx_autodoc_typehints.
@trevorbaca trevorbaca added the docs label Jan 4, 2025
@trevorbaca trevorbaca added this to the 3.20 milestone Jan 4, 2025
@trevorbaca trevorbaca self-assigned this Jan 4, 2025
@trevorbaca trevorbaca merged commit aa2d295 into main Jan 4, 2025
5 checks passed
@trevorbaca trevorbaca deleted the trevor/remove-sphinx-autodoc-typehints branch January 4, 2025 21:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant