Recent posts

  • 06 December - Read the Docs newsletter - December 2022

    This newsletter contains the first features and updates that have hatched since we announced a Q4 focus on core platform features in the previous newsletter.

    Here are the latest updates from our team:

  • 14 November - Override the build process completely with build.commands

    We are happy to announce a new beta feature that allows users to override the Read the Docs build process completely. We previously talked about executing custom commands in-between the Read the Docs build process. That approach is not sufficient for projects with a heavily customized build process, or those that want to use a different documentation tool like Pelican, Docsify and Docusaurus for their documentation. Some of which were not able to use our platform at all. Until now! We have good news for them!

    The new configuration file option build.commands allows projects to only execute exactly the commands they want. No more. No less. This means that Read the Docs won’t execute any of the default commands behind the scenes. You have 100% control over the build process.

  • 07 November - Read the Docs newsletter - November 2022

    Here are the first features and updates that have hatched since we announced a Q4 focus on core platform features in the previous newsletter.

    The latest updates from our team:

  • 01 November - Announcing sphinx_rtd_theme 1.1.0

    We are happy to announce the release of new version of our theme, sphinx-rtd-theme. In this release, we have focused on bug fixes, backwards compatibility, and making the way for future releases.

    Visually, we have a couple of small tweaks that most people won’t notice unless we mention them here 😇 The objective of the 1.1 release is to maintain backwards compatibility, and that also goes for the visual parts.

  • 25 October - GitLab service re-connection required

    Some months ago GitLab started enforcing an expiration time of two hours for all of their OAuth tokens.

    Unfortunately this broke the integration with our application, so your OAuth tokens may have expired. OAuth tokens are used to interact with the GitLab API, for reporting the status of merge requests, creating webhooks, and listing repositories. In order for Read the Docs to have access to new fresh tokens, you need to re-connect your GitLab account. You can do this by:

  • 12 October - Read the Docs newsletter - October 2022

    September was exciting because a few members of our team finally got to gather in person. Manuel, Benjamin, and Eric all attended Djangocon Europe in September, and had lots of great discussions around documentation.

    Also, as we mentioned, in Q4 we’re going to be focusing on our core platform features. This means we’ll have fewer new features to talk about, but lots of smaller improvements to the overall experience of using Read the Docs.

  • 05 October - Auto-canceling builds when pushing to the same branch twice

    Read the Docs allows you to keep your documentation up to date in a simple way, by triggering a new build each time developers push a git repository. Depending on your workflow, there could be situations where multiple pushes are done during a short time window. This causes a situation where you have to wait a long time for a build that will be immediately overwritten.

    To avoid waiting for those builds to be executed, we implemented a new feature to cancel these useless builds and only execute the latest one. This considerably improves the user experience and also reduces resource costs and energy waste.

  • 13 September - Knowing more about how people use our service

    Read the Docs generates a lot of data. We are the largest documentation platform out there, with hundreds of thousands of projects using our product every day to host their documentation. This data includes simple things like number of users, builds using a particular Docker image, as well as more interesting ones like pageviews or Python dependencies installed via a requirements.txt file. We didn’t collect this data in a systemic way during the first 10 years of our existence.

    Last year, with the growth of our product and the team, plus the CZI grant we received, we started asking ourselves some questions that we couldn’t answer with the data we had. We decided to start working on a project to collect relevant data to answer a large number of questions about how people use our service.

  • 12 September - Read the Docs newsletter - September 2022

    Our focus for August has continued to be around marketing and community outreach. We continue to better understand how our customers view our product, and work with them to use it well.

    We’re working to establish our goals for Q4 2022, and it looks like continued focus on polishing core platform features. We have a lot of features, and we need to continue making them easier to use.

  • 17 August - Read the Docs newsletter - August 2022

    We continue to be excited about the expanded capacity we have with an additional team member. Our focus for July has been around a lot of marketing and positioning, trying to better understand how our customers view our product, and work with them to use it well.

    We also had our 12th birthday just before publishing this newsletter. 🎉