Repository navigation
DOC: zarr-http-server docs are incomplete, missing guide.md #4291
Description
Describe the issue linked to the documentation
The docs for zarr-http-server are incomplete. For example, the README and /docs mention a guide (and there is a /docs/guide.md), but the link is broken and it doesn't appear to be accessible via the docs site.
Working, appears to be index.md:
https://zarr.readthedocs.io/projects/zarr-http-server/en/latest/
Not working, linked as user guide in the README:
https://zarr.readthedocs.io/projects/zarr-http-server/en/latest/guide/
Suggested fix for documentation
Please update or rebuild the docs site to include the new page?
Activity
psobolewskiPhD commentedon Aug 26, 2026
Note:
/stable/confusingly redirects to zarr-python docs?https://zarr.readthedocs.io/projects/zarr-http-server/en/stable/
So something must be up with the deployment of the docs?
d-v-b commentedon Aug 26, 2026
Thanks for the report, I'll get fixed in shortly! No clue what's up with RTD latest, I might have to learn more about our RTD configuration
psobolewskiPhD commentedon Aug 26, 2026
No rush, the .md is perfectly fine for me. Just wanted to let y'all know!
d-v-b commentedon Aug 26, 2026
so the underlying issue is that RTD simply can't do a
stablepage for subpackages. It chooses a commit forstablebased on the most recent semver-like tag, which will be tags forzarrreleases (not what we want forzarr-http-server!). Without a way to customize the tag pattern RTD looks for, we have to simply disable thestableversion entirely. So i've done that. I also switchedzarr-pythonto use the RTD github app, which unblocked the thing preventing thelatestdocs page from working. So next I need to make redirects fromstabletolatest.with that I think this can be closed? LMK if I need to re-open it.
docs: fix links flagged by the weekly link check - #4291 (#4292)