Company highlights¶

• 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.

New features¶

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.

Upcoming features¶

• 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.yaml files per repository.

Possible issues¶

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!