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.
The latest updates from our team:
We fully rolled out support for auto-cancelling running builds when a user does multiple pushes to a branch in a small window of time. We wrote up a full post on the blog about it, where you can read more.
Redirects can now be edited directly in our dashboard. This was an oversight that we are glad to have finally fixed the UX around.
We fixed the bug we had previously mentioned around Gitlab tokens expiring. This caused PR builds for these users to stop properly reporting status. If you login with Gitlab again on our service, they will continue working indefinitely now.
You can always see the latest changes to our platforms in our Read the Docs Changelog.
Our roadmap hasn’t progressed too much from last month, and we continue to focus on these core platform upgrades:
We’re working on improving our integration with Material for MkDocs, which is a great theme for MkDocs documentation projects.
Many improvements to our URL handling code, which will allow us to support more flexible URL configurations for projects.
A search redesign to make it nicer across our dashboard and in-doc search experiences.
We continue planning to be more active in deprecating old and outdated approaches to using our platform in Q4. We don’t have anything firm to announce here yet, but we do plan to be more active in removing these features in the coming months.
We continue to actively deprecate jQuery from our code, as well as guide the Sphinx ecosystem through the transition.
Tip of the month¶
This month’s tip comes from our Twitter account:
Are you in doubt about which Sphinx theme to use? 🎨— Read the Docs (@readthedocs) September 16, 2022
Take a look at https://t.co/9w3JvCmlJj -- it has awesome live demos that will help you decide which theme is the best fit for your project. pic.twitter.com/Hr1K2bbJhd
Considering using Read the Docs for your next documentation project? Check out our documentation to get started!
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.
- 06 December - Read the Docs newsletter - December 2022
- 14 November - Override the build process completely with build.commands
- 07 November - Read the Docs newsletter - November 2022
- 01 November - Announcing sphinx_rtd_theme 1.1.0
- 25 October - GitLab service re-connection required