Open
Description
Consider explaining how the .. function:: and .. module:: directives work, specifically that they don't produce headings displayed in the right menu. This means that each new function section should start with an .. _anchor:, which should do either of the following:
- Be linked to in the "List of all functions"/"Index" section on the module page. This way the reader can follow the link to go to the desired page.
- Be put in the hidden
.. toctree::on the module page. This way the link to a specific function API appears in the left menu in the tree.
Follow-up to #3024
Originally posted by @patiencedaur in #3024 (comment)