Use sphinx_autodoc_typehints

[jwodder]

Closes #7404.

[codecov]

Codecov Report

Patch coverage has no change and project coverage change: +0.13 🎉

Comparison is base (9c91ff9) 88.10% compared to head (c4172d8) 88.23%.

Additional details and impacted files

@@            Coverage Diff             @@
##            maint    #7412      +/-   ##
==========================================
+ Coverage   88.10%   88.23%   +0.13%     
==========================================
  Files         327      327              
  Lines       44692    44692              
==========================================
+ Hits        39374    39435      +61     
+ Misses       5318     5257      -61     

see 17 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[yarikoptic]

could you give an example on how it works -- i.e. shot of documentation before/after?
does it detect/warn about "conflicts" or incongruencies (type hint says one and docstring already says smth different), or what does it do -- replaces or leaves original?

[jwodder]

@yarikoptic

Before

After

If the docstring already contains type information, the docstring takes precedence; there is no warning.

[yarikoptic]

hm, RTD doesn't report on builds ... and seems to not build for PRs even though enabled. Following the docs I "resynced the hook" (under https://readthedocs.org/dashboard/datalad/integrations/92281/). Let's see if helps.

edit: that did the trick. #7413 already has RTD reporting status back.

[yarikoptic]

I think it is a good thing.

[yarikoptic-gitmate]

PR released in 0.18.5