Introducing latest options for operating system and build tools
Photo by Ben Allan on Unsplash

Photo by Ben Allan on Unsplash

We generally recommend projects pin specific versions of their dependencies, so that builds are reproducible over time. However, some projects under active development prefer to use the latest versions available to take advantage of new features and improvements, without having to update the configuration file every time a new version is available.

We are happy to announce support for using the latest available version for the operating system and build tools configuration options. The following new option values are available:

  • build.os: latest
  • build.tools.python: latest, miniconda-latest, mambaforge-latest
  • build.tools.nodejs: latest
  • build.tools.ruby: latest
  • build.tools.rust: latest
  • build.tools.golang: latest

When using these values, the latest version available on Read the Docs will be used, which may not match the latest version officially released. Check our documentation for the list of versions available for each option.

Versions for operating system and tools will be updated at least once every six months. Keep in mind that your builds may break unexpectedly if your project isn't compatible with the newest versions when they are updated on Read the Docs. We recommend using specific versions of dependencies for projects that require stability.