Read the Docs newsletter - January 2023¶
News and updates¶
Here are the latest updates from our team since the previous newsletter:
📹️ Eric delivered a talk at DjangoCon US 2022 with practical tips for developing state of the art documentation projects. You can watch it here: Documenting Django Code in 2022
🛠️ In line with the talk, we continued reorganizing our own documentation to follow the Diátaxis Framework.
🚢️ Sphinx 6.0 and 6.1 have been released. If you want things to not break, it’s good to wait a bit. Read our considerations for upgrading.
🔒️ We fixed a security vulnerability on our platform. See: GHSA-368m-86q9-m99w
🔒 We immediately rotated Circle CI secrets as advised by Circle CI. Read the Docs did not share secrets with Circle CI for build infrastructure, nor do we see any signs that other secrets have been suspiciously accessed.
You can always see the latest changes to our platforms in our Read the Docs Changelog.
The core team has laid out its 2023 Q1 roadmap and our general focus will be on:
Improving support for using any documentation tool in the build process.
Currently, users can either customize a default build process or overwrite the entire process from scratch. We are aligning these two approaches, making it easier to design and configure builds for a project’s individual needs.
Continuing to restructure and rewrite the user documentation of Read the Docs. We look forward to publishing the restructured documentation which is likely happening at the end of Q1.
Dashboard redesign: Our admin dashboard is currently being redesigned and reimplemented. We are targeting the work to be presented in a public beta.
Interested in all the details? View our full Roadmap 📍️
Sphinx users should be aware that Sphinx 6.0 and 6.1 were released very recently. If you haven’t pinned dependencies, the update might come automatically. If you choose to update, there are a few things to be aware of. Read our considerations for upgrading.
If the release of Sphinx 6 has made your builds fail, it may be because you are not pinning your dependencies. We recommend reading our introduction to Reproducible Builds.
Awesome Project of the month¶
GeoPandas is an open source project for working with geospatial data which requires a lot of exciting features from the documentation - maps, plots etc. We especially like how the documentation is structured. See all the highlights in the following Twitter thread:
GeoPandas is an open source project to make working with #geospatial data in #Python easier. @GeoPandas extends the datatypes used by pandas to allow spatial operations on geometric types.— Read the Docs (@readthedocs) December 14, 2022
We want to highlight some things we love from their docs.
🤏 (small) 🧵 pic.twitter.com/Hj82s6SDQP
Awesome Read the Docs Projects List 🕶️¶
Looking for more inspiration? Check out our new list Awesome Read the Docs Projects and help us discover more awesome projects.
Read the Docs for Business¶
Considering using Read the Docs for an organization?Discover all the features ✨️
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”