Would it be possible to make the readthedocs available for download? Zarr and icechunk have it available but xarray doesn't provide the option it seems

[abidsikder]

I wanted to download a text file of the complete docs for use with an LLM.

Xarray's read the docs shows this

Zarr's readthedocs flyout shows this handy link:

[ianhi]

The docs are availabe here: https://github.com/pydata/xarray/tree/main/doc, which you can access and point an LLM at.

But it also could be nice for someone with the correct permissions to set this up on RTD website. Or it also looks as though this can be done via a PR to our readthedocs.yaml file with these setitngs: https://docs.readthedocs.com/platform/stable/guides/enable-offline-formats.html

[keewis]

zarr has formats: all in its .readthedocs.yaml file. While this works, it means that for each commit to main we'd build the docs four times (html, html+zip, pdf, epub).

For zarr, the total build time is 2 mins (for all 4 builds). xarray's docs take roughly 7 mins to build individually (we used to take ~15 mins, not sure what happened), so we'd spend about 30 mins of build time for each commit.

All that to say that while I'm open to building additional versions, I'd prefer the 4 builds to only happen on released versions, and not on every commit.

[abidsikder]

I did take a look at the doc directory, it has the written guides and content but lacks the API auto geneated from docstrings it seems. I assume all of that gets auto generated for the online html docs build.

As for the additional versions, would it be possible to just make the html available? I assume that would not be additional build work since that's what the website is already using, and would be plenty suitable for collating together (more than pdf and epub formats at least 😅)