[Docutils-develop] Adding type hints directly to docutils?

[Stephen F. <st...@th...>]

o/

I recently had to contribute a fix to the stubs type hints package for docutils
in typeshed [1]. Is there any reason *not* to add these directly to docutils? I
would be willing to tackle this effort if it would be welcomed (I previously
tackled the "make docutils support Python 3 natively" effort, along with some
smaller quality-of-life fixes).

As a follow-up to the above, are there any significant concerns with using a
tool like 'ruff format' or 'black' to auto-format code before adding the
annotations? It's small thing but it would make the process of folding in hints
somewhat easier if I can rely on tooling to handle formatting for me.

Cheers,
Stephen

[1] https://github.com/python/typeshed/tree/main/stubs/docutils