Read the Docs newsletter - August 2023

News and updates

  • 🏝️ A few team members took vacations this month, and everything kept running smoothly, which is always wonderful to see.

  • ⏩ Our git cloning code was refactored, and now projects should be building much faster. The more git branches and tags you have, the faster the build will be.

  • 🆕 All new projects imported on Read the Docs get the latest versions of our default documentation tools installed. This is the goal of our large set of deprecations lately, and now all new projects are starting in a place where we want all projects to get to.

  • 💵 We are working to simplify our subscriptions on Read the Docs for Business, to make it easier for customers to know what they are getting, and for us to ensure all the features in each plan align with our pricing page.

  • 🔒 We shipped a change to authentication on our build servers to dramatically reduce the permissions required when building documentation. This increases our “defense in depth” security posture, and reduces the risk of a security breach.

You can always see the latest changes to our platforms in our changelog.

Upcoming features

  • Our marketing website (https://about.readthedocs.com/) transition will be finishing up next week. We will be redirecting all logged out Read the Docs Community users to the new site, completing this migration.

  • We continue to finish rolling out our updated Proxito v2 code. This is fully rolled out to Read the Docs Community, and has a couple customers we’re waiting on to migrate Read the Docs for Business. This will happen in August.

  • We are rolling out HTML search indexing for all projects. This removes a small bit of functionality from our search for Sphinx projects, but makes it much more reliable across all documentation tools.

  • We continue to work on a revamped flyout using our addons system. This is the first step in a larger project to improve the user experience of our documentation platform.

Want to follow along with our development progress? View our full Roadmap 📍️

Possible issues

  • Continuing deprecations: 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.tools and build.commands instead of feature flags. You can see the full list and timeline on issue #10587 & issue #9779.


Questions? Comments? Ideas for the next newsletter? Contact us or just reply to this email.