We have historically built all of our documentation from the sphinx source in the main matplotlib/matplotlib repo (this one). We would then host this by unpacking the result of the build at the top level of website + into a version specific sub-folder. We would also rely on

While this served us well for over a decade, over the past few years we have slowly started to pull things apart. The goal is to ultimately de-couple the version independent parts of the documentation (which should be re-published as soon as they are update) from the version-specific docs (which should be Steps we have already taken so far:

• move the cannonical docs tohttps://matplotlib.org/stablehttps://discourse.matplotlib.org/t/canonical-documentation-have-moved/21863
• split the third-party docs out into its own repohttps://github.com/matplotlib/mpl-third-party
• have a sphinx theme for all of our websiteshttps://github.com/matplotlib/mpl-sphinx-theme
• split the top-level index into its own repohttps://github.com/matplotlib/mpl-brochure-site
• have built docs for the governancehttps://github.com/matplotlib/governance
• moved our ground-truth hosting to digital oceanhttps://github.com/matplotlib/matplotlib.org

The next thing we should pull out into its own repository is the content underhttps://matplotlib.org/stable/devel/index.html . We probably should copy-paste the GHA/sphinx configuration from the governance repo and update the rst in that framework.

We should do this as a second step after we finish@noatamir 's update of that content (to make it easier to review the changes at each step).