Recent posts

  • 14 October - Ubuntu 20.04, Python 3.10, and support for Node, Rust, and Go

    We are excited to announce that now Read the Docs users can use a newer build specification in their projects that will change the base image to one based on Ubuntu 20.04, ship the recently released Python 3.10, and allow users to easily specify the version of Node.js, Rust, and Go. This feature has been a long time in the making, and we think it will simplify the configuration of many projects.

    The Docker images used by our builders were based on Ubuntu 18.04. Recently, we added a new feature to install custom system packages, which allowed many projects to have better control of their build process without having to use conda to manage non-Python dependencies.

  • 07 October - Read the Docs newsletter - October 2021

    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 have resumed sending our blog updates by email. You can subscribe to our newsletter so you don’t miss them.

  • 02 September - Read the Docs newsletter - September 2021

    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 have published the first release candidate of version 1.0.0 of our Sphinx theme, which adds support for recent versions of Sphinx and docutils among other things, and announced our future plans for it. Check out the linked blog post to know more. Update: We have released 1.0 to PyPI

  • 23 August - Theme release 1.0.0rc1

    The 1.0.0 version of sphinx_rtd_theme was released Sept 13, 2021. You can install the latest version with:

    Alternatively, you can upgrade the version installed using:

  • 09 August - Read the Docs newsletter - August 2021

    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 have a new team member! Ana just joined us as Frontend Developer in the context of the CZI grant we were awarded to work on our JavaScript documentation embedding client and the Read the Docs redesign and UX.

  • 08 July - Read the Docs newsletter - July 2021

    Welcome to a new 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.

    Eric presented the history of the company at the Upstream 2021 conference along with ideas for open source sustainability. You can read more about it in our recent blog post.

  • 06 July - Early 2021 talks and podcasts from Read the Docs

    During the first half of 2021 several team members of Read the Docs have talked about the company in podcasts and online events. If you want to learn more about our company directly from the people that are a core part of it, and hear our thoughts on other topics like open source sustainability and developer advocacy, this blog post is for you.

    Eric was the special guest of Sustain back in February, “a podcast about sustaining open source in the long haul”. Eric started by telling the story of how he and Anthony co-founded Read the Docs, talked about the Write the Docs community, described the challenges of launching EthicalAds in 2020, and discussed the opportunities of using ethical advertising to fund open source projects.

  • 10 June - New release of sphinx-hoverxref with support for intersphinx

    We have released version 0.6b1 of sphinx-hoverxref, a Sphinx extension that shows a content preview of a cross-reference.

    This extension is an essential part of the work we are doing to improve interoperability of documentation in general, and scientific documentation in particular, thanks to the CZI grant we received last year.

  • 03 June - Read the Docs newsletter - June 2021

    Welcome to a new edition of our monthly newsletter, where we openly 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 applied to the next round of the CZI Essential Open Source Software for Science! Our proposal is even more ambitious than the previous one, and we are excited about the possibilities for our users if we get accepted. The funding would cover 2 years of work, starting in 2022.

  • 19 May - Install custom operating system packages (apt)

    We are thrilled to announce that now Read the Docs users can declare custom operating system packages in their project configuration that will get installed in our Ubuntu-based builders using apt. This has been a long awaited feature, and we think it will simplify the configuration of many projects, especially scientific ones.

    The Ubuntu images used by our builders contain lots of preinstalled system packages that we ship to all the projects to make the most common use cases possible. This includes compilers, development headers of common libraries, and others.