Skip to content

Commit bf31e93

Browse files
authored
Post: Introducing latest aliases (#259)
* Post: Introducing latest aliases Closes #256 * Updates from review
1 parent 8209d41 commit bf31e93

File tree

2 files changed

+31
-1
lines changed

2 files changed

+31
-1
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
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.

prospector-more.yml

-1
This file was deleted.

0 commit comments

Comments
 (0)