|
| 1 | +title: Introducing latest options for operating system and build tools |
| 2 | +date: 2024-02-15 |
| 3 | +category: Changelog |
| 4 | +tags: configuration-file, config-file |
| 5 | +authors: Santos Gallegos |
| 6 | +status: published |
| 7 | + |
| 8 | +We generally recommend projects pin specific versions of their dependencies, |
| 9 | +so that builds are [reproducible](https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html) over time. |
| 10 | +However, some projects under active development prefer to use the latest versions available to take advantage of new features and improvements, |
| 11 | +without having to update the configuration file every time a new version is available. |
| 12 | + |
| 13 | +We are happy to announce support for using the latest available version for the |
| 14 | +[operating system](https://docs.readthedocs.io/en/stable/config-file/v2.html#build-os) |
| 15 | +and [build tools](https://docs.readthedocs.io/en/stable/config-file/v2.html#build-tools) configuration options. |
| 16 | +The following new option values are available: |
| 17 | + |
| 18 | +- `build.os`: `latest` |
| 19 | +- `build.tools.python`: `latest`, `miniconda-latest`, `mambaforge-latest` |
| 20 | +- `build.tools.nodejs`: `latest` |
| 21 | +- `build.tools.ruby`: `latest` |
| 22 | +- `build.tools.rust`: `latest` |
| 23 | +- `build.tools.golang`: `latest` |
| 24 | + |
| 25 | +When using these values, **the latest version available on Read the Docs will be used, |
| 26 | +which may not match the latest version officially released**. |
| 27 | +[Check our documentation](https://docs.readthedocs.io/en/stable/config-file/v2.html) for the list of versions available for each option. |
| 28 | + |
| 29 | +Versions for operating system and tools will be updated at least once every six months. |
| 30 | +**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.** |
| 31 | +We recommend using specific versions of dependencies for projects that require stability. |
0 commit comments