Read the Docs newsletter - July 2023¶
News and updates¶
🚀 We shipped support for customizing the URL path for projects and subprojects, allowing you to remove or customize the /projects/ path on subprojects. This is enabled via Support request currently, and only on certain plans on Read the Docs for Business.
🛣️ Deprecations underway: We have a number of old feature deprecations underway. The goal here is to reduce complexity of our build platform, and enable users to control their own builds via
build.commandsinstead of feature flags. Keep an eye on your email for any deprecation notifications that might impact your project.
📧️ Getting too many deprecation notifications? We added the ability to opt out of email notifications. You can configure this in your user profile settings.
✅️ New tool updates for all build tools, including the latest stable versions of Python, PyPy, Node.js, Rust and Go. See the documentation of the build.tools for more info.
⏩️ HTTP speedups: Several HTTP endpoints and CloudFlare configurations have been tweaked and are performing better.
🐛️ Bug fix: We are now 100% relying on search indexing by parsing HTML, instead of special Sphinx-only logic. This makes search a lot simpler and more consistent for our users.
⏩️ Our build process is receiving considerable improvements for larger Git repositories. The
git fetchoperations are tweaked, which results in significant speedups. For instance, the CPython project now fetches its Git repository at nearly 10x the speed of before. The change is being deployed soon to a few select projects and then gradually rolled out. For more details, see issue #9736.
🚢️ We have concluded work on the first phase of our new Read the Docs Addons. Our Addons will be a single library for all the ways Read the Docs enhances documentation. There will be integration points and APIs to customize all of these features in the new client.
We will start to use it on a few selected projects. If you are interested in having it enabled on your project, please reach out.
Want to follow along with our development progress? View our full Roadmap 📍️
⚠️ Please make sure to read the blog post: Migrate your project to .readthedocs.yaml configuration file v2.
If you didn’t have a
.readthedocs.yamlconfiguration file, and you are introducing one for the first time, we’re excited for you to be able to use all our new features like specifying build tool versions (Node, Rust, etc.)!
The blog post offers help with that 💡️
Awesome project of the month¶
We are adding new entries to the list of Awesome Read the Docs Projects 🕶️. Feel free to open an issue or pull request if you’ve seen something that might inspire others.
This month’s addition is the developer documentation for django-cms, which is noted for being both extremely extensive and well-organized at the same time. It uses the Furo theme that has full integration with Read the Docs’ reader extensions.
Questions? Comments? Ideas for the next newsletter? Contact us!
Subscribe to our mailing list
Sign up for our blog and we'll send you news and updates about Sphinx and Read the Docs on a regular basis.
You have successfully joined our subscriber list.
- 05 September - Read the Docs newsletter - September 2023
- 31 August - Addons flyout menu beta
- 24 August - Enabling latest versions for Sphinx & Mkdocs builds
- 09 August - Use build.os instead of build.image on your configuration file
- 08 August - Drop support for “Use system packages”