Feature request: link anchors for docstring sections

[rossbar]

I did a quick scan of the issues and didn't see this proposed anywhere - apologies if I missed related discussions.

It would be a nice feature to have the docstring sections (e.g. Parameters, Notes, Examples, etc.) be linkable with a link anchor. Some docstrings are quite long, and a user may want to link to a component of the docstring, say the Examples. Having the ability to click on sections to have them snap to the top of the page, as well as share links with anchors (e.g. my_docstring.html#examples) would be great.

[12rambau]

I looked at this issue, That won't be so complicated to add a caption "#" but autosummary is generating all the doctrisngs section as dt without adding any Id to the DOM elements. Maybe this should be handled at a higher level (Sphinx) ?

[12rambau]

I will close this one as it cannot be handled easily from the theme itself. If you find a hack from your side please fill free to share it in the comment section