have versioned docs. I.e. a nice visible drop-down on the web interface such that people can switch from nightly to release

[poshul]

          I think it would be better to have versioned docs. I.e. a nice visible drop-down on the web interface such that people can switch from nightly to release. This means we would just keep the currently supported versions up-to-date here.

Would be nice to have a versions file in the OpenMs repo that lists the supported versions which is then also used by our nightly jobs to request those python versions from the runners. If those runners do not support these versions anymore we get an error. The docs and website would then read the versions from that file.

_Originally posted by @jpfeuffer in https://github.com/OpenMS/pyopenms-docs/pull/340#discussion_r1105910595_

See https://stackoverflow.com/questions/49331914/enable-versions-in-sidebar-in-sphinx-read-the-docs-theme

how to display versioned docs better. Feel free to delegate to the doc team.

[jpfeuffer]

This will also require a little bit of rethinking how to write our environment.yml/requirements.txt files and our actions. Things to consider:

• Release docs are on a release branch or tag and will need a fixed pyopenms version to be installed, either via reqs/env or in the action
• Currently the nightly pyopenms package has a different name!! I think we tried to avoid the name clash on the public pypi back then -> I think we should name it back, now that we have an own pypi. Probably the logic in the pyopenms build action should be: if release, publish to public pypi AND local, if develop, publish only to local pypi with a .devDATE suffix (following PEP, as we do for conda).

[jpfeuffer]

Related #348

[timosachsenberg]

I added you because it sounds like it requires a bit deeper understanding of the build steps / requirements.

[jpfeuffer]

see #354. One of the many benefits.

[jpfeuffer]

No understanding needed by the way. I will figure out the Readthedocs. This task is just to display what Readthedocs already does.

[timosachsenberg]

any update here?

[jpfeuffer]

See the linked PR. Apparently tapasweni abandoned the project again. So I think we should go with my PR.

[timosachsenberg]

what was the update on this project. I think you have been working on something on the retreat

[jpfeuffer]

No, not regarding this

[timosachsenberg]

I think this is done?