CI: RTD builds fail more often than before

Example: https://app.readthedocs.org/projects/cupy/builds/34013734/

In the long run, once we migrate to always use cuda.bindings and nvmath.bindings, there is no need to maintain the stub builds (for RTD) anymore. We can just do the regular CUDA build.

https://app.readthedocs.org/projects/cupy/builds/34044890/

@kmaehashi

Update: Discussed in the August meeting, we will explore reusing wheels built in GHA so that we avoid building CuPy (against stubs) in RTD. @kmaehashi will grant me access to the RTD project to start exploring.

I've got access to the project on RTD! Will look into it maybe next week.

WIP

Turns out that we rely on the direct upload approach in #10350 but it is currently a beta feature so not turned on by default...
https://docs.readthedocs.com/platform/stable/guides/build/direct-upload.html#direct-upload
I've filed a support ticket to RTD.

I've filed a support ticket to RTD.

RTD direct upload is enabled:

Hi Leo,

Thanks for contacting and helping us testing the Direct upload beta feature. I just enabled it on your cupy project.

Here is the documentation for direct upload: https://docs.readthedocs.com/platform/latest/guides/build/direct-upload.html

You can build the docs following the pattern you mentioned. Basically,

- build PR outside Read the Docs (e.g. with the GitHub Action) and upload the docs
- build the "real versions" (latest, stable, vX.Y.Z) on Read the Docs using our builders

To avoid building PR twice (externally and on Read the Docs) you have to disable the PR building on Read the Docs from you project's settings.

I'd really appreciate if you can share any feedback you may have about the Direct upload feature since we are still polishing it and we can make it better based on real user's feedback.


Regards,
Manuel Kaufmann
Read the Docs

All PRs are merged, and the stubs are nuked! 🚀

Navigation Menu

Repository navigation

CI: RTD builds fail more often than before #10185

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

CI: RTD builds fail more often than before #10185

Description

Activity

leofang commented on Aug 13, 2026

leofang commented on Sep 3, 2026

leofang commented on Oct 2, 2026

leofang commented on Oct 5, 2026

leofang commented on Oct 5, 2026

leofang commented on Oct 6, 2026

leofang commented on Oct 16, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions