Read the Docs newsletter - January 2022¶
Welcome to the latest edition of our monthly newsletter, where we share the most relevant updates around Read the Docs, offer a summary of new features we shipped during the previous month, and share what we’ll be focusing on in the near future.
We are now managing custom domains for our corporate users using Cloudflare SSL for SaaS, which will remove the manual work that was needed on our side and make the process of setting up a custom domain almost instantaneous. It also will allow us to offer a CDN much easier in the future.
We improved our spam classification system, and started blocking the dashboard on spammy projects. We are happy to report that the traffic to spammy projects has already reduced significantly.
December and January have been slow months, and we mainly worked on internal changes and documentation improvements. Among the major user-facing changes:
We changed the Google Analytics from a persistent 30 day cookie to a session cookie that is deleted when the browser is closed. This will result in less data collected from users.
We split the developer documentation from the user documentation to avoid confusion and made our Read the Docs for Business docs more visible.
We expanded our user documentation with more examples on how to use MyST Markdown and a guide to migrate from reST to MyST (more about our committment to support MyST in our blog).
Thanks to our external contributor Çağatay Yiğit Şahin.
You can always see the latest changes to our platforms in our Read the Docs Changelog.
Ana will continue working on the new landing pages, polishing the copywriting along with Juan Luis and translating the mockups to Pelican templates.
Anthony will continue working on frontend scaffolding and finance bits.
Eric will continue to focus on business and sales efforts, and performing code review.
Juan Luis will work with Ana in the new landing pages, and with Manuel in a new process to migrate users from legacy or deprecated configurations.
Manuel will wrap up the migration to Django 3, improve the queryability of the project configuration in our database, and refactor our task queue to improve its robustness.
Santos will add support for multiple
.readthedocs.yamlfiles per repository.
The Python packaging ecosystem is evolving rapidly to accomodate for modern standards that will make our life easier, and in particular setuptools has been introducing some breaking changes in recent times. We anticipated this sort of breakage for our users so we pinned the setuptools version in late November. However, a small number of projects did not have this version cap active because of a bug on our side and experienced failing builds after a new setuptools release. We quickly fixed the problem and offered a range of possible solutions to affected projects.
Considering using Read the Docs for your next Sphinx or MkDocs project? Check out our documentation to get started!
- 12 January 2022
- Juan Luis Cano Rodríguez
- Madrid, Spain
- 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.
You have successfully joined our subscriber list.
- 31 May - Migrate your project to .readthedocs.yaml configuration file v2
- 11 May - Read the Docs newsletter - May 2023
- 07 April - Read the Docs newsletter - April 2023
- 09 March - Read the Docs website migration to about.readthedocs.com
- 07 March - Read the Docs newsletter - March 2023