RTD flyout view page source link is broken for API docs about bytewax

[davidselassie]

This is because there is no permanent source for API docs pages. They are re-derived at documentation build time from the Python source code. This is so the documentation files never fall out of sync with the docstrings in the code.

We correctly disable the blue Edit on GitHub link in the right side bar for API docs pages because of this, but the link described here is injected by Read the Docs. I'll see if there's a way to turn it off selectively for these pages that are derived.

[davidselassie]

To clarify: this link is only broken on API Docs section pages and does work correctly on all the documentation in the User Guide section, for which there is an actual markdown file checked in.

[davidselassie]

It looks like this menu, officially called the flyout menu is not currently customizable.

One option we have here is to disable the RTD-provided flyout menu, and instead enable the Sphinx PyData theme version switching UI and theme source link. Then we can use the per-page template definitions to only show those links for non-API pages. (I believe we are currently doing this for the "Edit on GitHub" link, so it'd be adding the sourcelink template to follow that pattern as well.)

[davidselassie]

It also might be possible to make a custom sourcelink-python partial template which could be activated for API docs which rewrites the link to the actual Python source code. Not sure all the details here and if there's a convenient source in the template you could use to rewrite the import path to the file path in Bytewax's GitHub repo.