pyopenms-docs icon indicating copy to clipboard operation
pyopenms-docs copied to clipboard

recent documentation versions (other than latest) inaccessible on readthedocs.io

Open jonathan-hunter opened this issue 11 months ago • 4 comments

What is the type of your request?

  • [X] Incomplete / missing
  • [ ] Typo
  • [ ] Unclear
  • [ ] Not reproducible

Include a description of your report

Some of the recent documentation versions don't work on 'readthedocs'. I'm using pyopenms (3.2.0.1) from pip and trying to track down a few missing functions in the version matched docs.

https://pyopenms.readthedocs.io/en/release3.2.0/

Image

State the documentation version the report is about

release3.2.0 (also 3.1.0, 3.3.0)

jonathan-hunter avatar Jan 22 '25 21:01 jonathan-hunter

Yes. Another result of the recent change of the release tag naming scheme @poshul

jpfeuffer avatar Jan 22 '25 22:01 jpfeuffer

this is still open. Can someone look into it!?

cbielow avatar Feb 06 '25 14:02 cbielow

The problem is that it is not clear what the future schema is supposed to be..

For years it was ReleaseX.Y.Z as tag. Now it has been "nothing" for 3.1.0, "release/3.2.0" as tag, "release/3.3.0" as branch and tag.

I added them manually to RTD and added ^release/ tag as new automation rule. Please let's stick to it.

jpfeuffer avatar Feb 06 '25 14:02 jpfeuffer

switcher.json was also wrong. The new parsing rules will convert the "/" into a hyphen. You will need to rebuild all doc versions to make use of the (now) corrected version switcher links.

jpfeuffer avatar Feb 06 '25 16:02 jpfeuffer