readthedocs.org
readthedocs.org copied to clipboard
The source code that powers readthedocs.org
We are currently serving `/README.html` and `/README.html` in https://github.com/readthedocs/readthedocs.org/blob/e85ee7dbadfec7735d89427ed7083b38ea22284e/readthedocs/proxito/views/serve.py#L301-L327 This is _not a standard behavior_ and we have it there because of pretty old compatibility reasons. I'd like to deprecate...
We use something called "Cold Storage" that removes old builds from our database and store them in a `.json` file in S3: https://github.com/readthedocs/readthedocs.org/blob/03c03fa4de2a52fb5bbbbd8ab047e485abcc310c/readthedocs/builds/tasks.py#L183-L240 We would need to think and discuss...
## Details My docs are built using mambaforge. If I list `sphinx` as a dependency (without a version number), then mambaforge tries to install the latest version (7.3.7), which leads...
Minimal viable pre-commit docs. --- :books: Documentation previews :books: - User's documentation (`docs`): https://docs--11445.org.readthedocs.build/en/11445/ - Developer's documentation (`dev`): https://dev--11445.org.readthedocs.build/en/11445/
Fully removal after deprecation and browndates. Reference: * https://github.com/readthedocs/readthedocs.org/issues/9993 * https://github.com/readthedocs/readthedocs.org/pull/11348 * https://about.readthedocs.com/blog/2024/05/readme-html-deprecated/
Opening a build details page for a project where you are not a maintainer returns 403 and show no notifications at all. 1. go to https://beta.readthedocs.org/projects/chemprop/builds/24161295/ 2. check the console...
Add a feature flag called `DISABLE_SPHINX_MANIPULATION` that: - don't install `readthedocs-sphinx-ext` Python package - don't append anything to the Sphinx's `conf.py` file - enable Read the Docs Addons on these...
Address [#11425](https://github.com/readthedocs/readthedocs.org/issues/11425) This is how I'm planning to handle the list of Addons. Add minimal changes to existing docs (I'm expecting some addons to need more than this) and link...
The idea here is probably for @humitos to write an initial draft and work with @plaindocs as a primary editor.
I thought I had written some tests around our filters, but not finding them at the moment. We could probably use a few spot checks on queryset output and we...