Read the Docs: Read the Docs newsletter - February 2023 :

Read the Docs: Read the Docs newsletter - February 2023
blow post content copied from  Planet Python
click here to view original post

News and updates

Here are the latest updates from our team since the previous newsletter:

  • 🪄️ Build outputs are now stored in a well-known location: _readthedocs/<format>. This opens up many new and exciting possibilities for generating and processing final output formats, which we will uncover in an upcoming blog post. PDFs for MkDocs and encrypted documentation are just two demos that we have ready. Stay tuned!

  • 🌪️ Uploads are faster and done in parallel, thanks our migration to rclone which is in staged deploy to ensure availability.

  • 🔒️ Cross site requests to our approved API endpoints now reject requests that include credentials (cookies). This functionality was not needed, and had the potential for future security issues.

  • 🛠️ The default branch of a Git repository is now correctly detected in manual imports. This was a long-standing bug that we are very happy to fix.

  • 🔒️ Security issue found and fixed: Path traversal: access to files from any project

  • 🔒️ Security issue found and fixed: Symlink following: Arbitrary file access from builder server

  • 🔒️ Security issue found and fixed: Cache poisoning

  • 🎤️ Write the Docs has announced their 2023 conferences. Read more in their announcement.

You can always see the latest changes to our platforms in our Read the Docs Changelog.

Upcoming features

  • More internal components of the build process will have a public API, giving full control and flexibility and allowing for more documentation tools to be used.

  • Our Diátaxis documentation refactor is entering final stages before the first reveal.

Interested in all the details? View our full Roadmap 📍️

Possible issues

  • 🚦️ There is a schedule maintenance window on Cloudflare that provides our CDN and SSL provisioning. We are working to ensure that nothing is offline other than creation of new domains:

    On February 14th, 2023, Cloudflare will be doing database maintenance that will impact SSL API availability and may result in certificate issuance delays. The scheduled maintenance will be on February 14, 2023, 14:00 - 16:00 UTC.

  • The change of the standard build output directory will cause issues for anyone that has custom builds and have guessed the old unofficial output directory. See technical details in

  • If you want to use Sphinx 6 with sphinx-rtd-theme, we have shipped an update of both the new theme and an update on our platform dealing with the removal of jQuery from Sphinx. See also Sphinx 6 is out and has important breaking changes.

  • In relation to the former update, we removed an injection of a legacy setting html_theme_path used with very old versions of Sphinx <1.6. Please make note of this in case you are building documentation with this version of Sphinx. The recommended fix for the issue is to upgrade your Sphinx version.

Awesome Read the Docs Projects 🕶️

System Message: INFO/1 (/home/docs/checkouts/, line 12); backlink

Duplicate implicit target name: “awesome read the docs projects 🕶️”.

Looking for more inspiration? We continue building Awesome Read the Docs Projects 🕶️, a list full of inspirational documentation projects.

Please feel invited to open an issue or pull request in the repository with your suggestions.

Questions? Comments? Ideas for the next newsletter? Contact us!

February 07, 2023 at 05:30AM
Click here for more details...

The original post is available in Planet Python by
this post has been published as it is through automation. Automation script brings all the top bloggers post under a single umbrella.
The purpose of this blog, Follow the top Salesforce bloggers and collect all blogs in a single place through automation.