Deploy multiple versions of the documentation

[niksirbi]

At present, we use the build_sphinx_docs and deploy_sphinx_docs actions from our re-usable actions repository, which only deploy a single version of the documentation (corresponding to the latest release) to GitHub Pages.

This means users and contributors cannot view older versions of the docs, except by checking out an old commit and building locally. Having access to documentation for previous releases would be extremely useful, especially when it comes to breaking changes.

Hosting multiple versions online would necessitate making changes to the actions themselves.
I've outlined the plan in more detail here: neuroinformatics-unit/actions#91

[vtushar06]

Hi @niksirbi,
Having multiple versions of the documentation available would definitely be valuable for users working with different releases.
I'm interested in contributing to this enhancement.

• what would be the preferred approach for version organization?

• Should I take a look at the NeuroBlueprint example first?

If this Issue is open for contributors I would love to give this a chance. Thanks

[niksirbi]

Hey @vtushar06, this needs to be first solved on our actions repository, see neuroinformatics-unit/actions#91.
@animeshsasan is already working on that, so it's best not to duplicate efforts.

[vtushar06]

ohh sure @niksirbi.