Recent posts

  • 10 January - Read the Docs newsletter - January 2024

    We have shipped New improvements to redirects, making our redirects much more powerful and flexible.

    We have shipped an updated approach to notifications. Currently there isn’t much UX difference, but as we move forward with this project we will be able to provide more context and control to users.

  • 03 January - New improvements to redirects

    As your documentation evolves, content is moved, and pages are renamed, leading to broken links for your users. Redirects allow you to point users to the new location of a page.

    We are excited to announce significant improvements to our redirects feature to make them more flexible and powerful.

  • 05 December - Read the Docs newsletter - December 2023

    We have shipped single version projects to allow projects to be versioned without having translations. This is a long-requested feature that we’ve excited to ship based on our Proxito refactor work.

    We improved our webhook security by requiring a secret to be configured for all webhooks. This will help prevent malicious actors from triggering builds and other actions.

  • 28 November - Introducing support for version-only projects

    URLs are an important part of your documentation. Users can infer from the URL if your documentation has or supports multiple versions or translations.

    Until now, Read the Docs allowed you to configure your project in two ways:

  • 14 November - Security update on incoming webhooks from integrations

    Webhooks from integrations (like GitHub) are used to:

    Trigger builds when a new commit is pushed to a repository.

  • 06 November - Read the Docs newsletter - November 2023

    Work continues on hardening Addons, our new in-documentation JavaScript client that supports all documentation tools. We’re looking for people in the community to test out this new functionality, and will be expanding access in the near future.

    Python 3.12 is now supported on builds, and is the default version used when you specify build.tools.python: 3 in your configuration file.

  • 24 October - Language codes are now normalized

    The following language codes are now normalized to be lowercase and use a dash as a separator instead of an underscore:

    nb_NO is now nb-no

  • 05 September - Read the Docs newsletter - September 2023

    🚀 We started testing a new flyout menu as part of our beta test for documentation addons. The beta test is currently limited to projects using the build.commands configuration key.

    🛣️ We continue to have a number deprecations in progress. We announced this month deprecations of installing using system packages, the configuration key build.image, and installation of pinned versions of Sphinx and MkDocs. Keep an eye on your email for any deprecation notifications, as we will continue to notify maintainers of projects that might be impacted.

  • 31 August - Addons flyout menu beta

    We are happy to announce that a new flyout menu is now available as part of the ongoing beta test for our latest project, Read the Docs Addons.

    After much hard work, we are excited to begin testing this feature with more projects. We have previously been testing other documentation features as part of this ongoing beta, but the flyout menu is by far the most prominent feature yet.

  • 24 August - Changes to default project dependencies

    This post was updated on Oct 10 to reflect all of the changes to installed dependencies

    We are announcing the deprecation of automatic installation of several key project dependencies, and builds will no longer install older documentation tool versions by default.