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