Wiping a Build Environment¶
Sometimes it happen that your Builds start failing because the build
environment where the documentation is created is stale or
broken. This could happen for a couple of different reasons like
not upgrading a package properly or a corrupted cached Python package.
In any of these cases (and many others), the solution could be just wiping out the existing build environment files and allow Read the Docs to create a new fresh one.
Follow these steps to wipe the build environment:
- Go to Versions
- Click on the Edit button of the version you want to wipe on the right side of the page
- Go to the bottom of the page and click the wipe link, next to the “Save” button
By wiping the documentation build environment, all the
and code files associated with it will be removed but not the
documentation already built (
Now you can re-build the version with a fresh build environment!