Closed soxofaan closed 1 month ago
I could zone in on these "WARNING: Explicit markup ends without a blank line; unexpected unindent." warnings: https://github.com/tox-dev/sphinx-autodoc-typehints/issues/467
majority of "WARNING: Explicit markup ends without a blank line; unexpected unindent" is actually from the legacy_alias
helper which uses [deprecated[(https://pypi.org/project/Deprecated/) to append a deprecation note in the docs, but sphinx_autodoc_typehints
directly appends a line after that which is bad reStructuredtext style
https://github.com/tox-dev/sphinx-autodoc-typehints/issues/467 is already resolved and they released version 2.2.3 which includes the fix :partying_face: eliminating a bunch of doc build warnings
I noticed quite a lot of warnings in when building docs locally today:
Might be good to give this a look.
also to consider: fail the doc build if there are (too much) warnings?