This should go into https://matplotlib.org/devdocs/devel/documenting_mpl.html#writing-examples-and-tutorials

Also:

• Check if we can use another pattern than the hack using a code block and importing the desired functions. It seems we could also use a documentation block (c.f. https://sphinx-gallery.github.io/stable/configuration.html#add-mini-galleries-for-api-documentation bullet point 2.)
• Consider adding the possibility for linking between examples. Is this technically only a ".. seealso::" directive?