nextcloud / nextcloud/documentation
Version Picker Issues on Dev Manual
@skjnldsv is already working on this.
Since May 15, 2026.
- Dominant language
- JavaScript
- Stars
- 628
- Forks
- 2.5k
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 135
Description
Hi there,
I've noticed some confusing behavior of the version picker in the lower left corner of the dev manual.
- clicking on any link to the dev maunal on https://docs.nextcloud.com/ will open the desired version, but the version picker in the lower left corner will always say "latest" independent of the actual version. the only way to check which version you're currently reading is checking the URL. This is my main source of confusion
- In the version picker, only the last few versions are available, never the complete history back to version 12. This may not be critical, but it's still surprising IMO.
- the stable version is available only as
stablein the version picker, not through the explicit version number. At the time of writing the issue that means: In the version picker, I seelatest,stable, 31, 30, 29, but not 32. Replacingstablewith32in the url does work, however. This, too, might not be too bad at first glance, but makes permalinking harder and IMO can also make it less transparent whatstablerefers to
What I already saw is that you build the dev manual with sphinx, but didn't quite understand the configuration and how the hosting is done. In this workflow builds are run, but uploads only go to artifact-storage, no actual deployment IISC. In the sphinx config, I found
which looks a bit surprising to me. The available versions apparently are defined at
so my points 2 & 3 would likely be relatively easy to address. If you agree with my suggestions, then I'd be happy to send a PR for that.
I couldn't find anything about point 1 though. If you have pointers on what'd need to be addressed, I'd also be happy to PR.
Looking forward to your reply.
Best
Hinrich
PS: I chose the "blank issue" rather than the "Documentation Improvement" issue template as this is more of a meta/configuration-bug, not about the actual content. If you prefer to have the issue in the template, I'm happy to re-create.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.