Read the Docs newsletter - June 2023¶
News and updates¶
⚠️ A
.readthedocs.yaml
configuration file will be required for your future builds. Read more about this change in Migrate your project to .readthedocs.yaml configuration file v2.✅️ Visiting a language slug of a project without specifying the version now redirects to the default version. For instance,
/en/
redirects to/en/latest/
.🍿️ All the talks from Write the Docs Portland 2023, which we sponsored this year, are ready to watch: Open the new playlist on Youtube.
🐛️ Builds with multiline
build.commands
should now be working reliably. Thanks to everyone who helped out!🐛️ sphinx-rtd-theme 1.2.1 has been released with an important bug fix that caused jQuery to not load in certain projects.
🔒️ We updated custom domain certificates to 1.2 as the minimum TLS version.
🔒️ A high-severity vulnerability has been fixed: Write access to projects via API V2 (/api/v2/project/* endpoints) for any logged-in user.
Possible issues¶
⚠️ Please make sure to read the blog post: Migrate your project to .readthedocs.yaml configuration file v2.
If you didn’t have a
.readthedocs.yaml
configuration 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¶
The most recent addition to Awesome Read the Docs Projects 🕶️ is Ray’s documentation 🕶️.
Ray is an open source project, consisting of several components that all have their own section in a combined documentation set.
See the highlights in the following Twitter thread or Mastodon thread:
The most recent addition to our awesome projects list is Ray's documentation 🕶️.
— Read the Docs (@readthedocs) May 31, 2023
Ray by @anyscalecompute is an open source project, consisting of several components that all have their own section in a combined documentation set.https://t.co/9YGpJvYpFD
Here is a 🤏 (small) 🧵 pic.twitter.com/QElmmJetPB

It was always better to use a .readthedocs.yaml
file.
It gives so many more options and makes it possible to version your configuration in your Git repository ⚡️¶
Questions? Comments? Ideas for the next newsletter? Contact us!
- 05 June 2023
- Benjamin Balder Bach
- Malmö, Sweden
- Newsletter
- newsletter python
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.
Thank you!
You have successfully joined our subscriber list.
Follow us
Recent Posts
- 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”