Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Unpin Rust toolchain version when building old docs

Open
#1,192 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
42/100
Issue type
Refactor
Clarity
Mostly clear
Activity status
Stale
Tech stack
github-actions, rust

Research direction

Start by reading .rust-toolchain.toml and identify the GitHub runner configuration used to build old documentation. Check how RUSTUP_TOOLCHAIN can override the file, then decide whether stable should apply locally, in CI, or both. Done means old documentation builds without requiring separate release-specific toolchains.

Written by the indexing model from the issue text.

Description

documentation question

We pin the Rust toolchain by way of a .rust-toolchain.toml file, but we mostly do so to make sure devs are all using the latest version. Rust has good backwards compatibility (often new functions etc. are added, but old code should compile with new compilers), so the latest version of the toolchain should be fine. In future, we will probably have a different pinned version of the toolchain for every release and making users/GitHub runners download all of them seems silly.

It seems you can tell rustup to use a specific version of the toolchain by setting the RUSTUP_TOOLCHAIN environment variable. This will override the setting in .rust-toolchain.toml, if any. We probably just want to set it to stable.

It's debateable whether we should make this a policy that is enforced both locally on CI or just on CI. Personally, I think we should probably be consistent and use stable for both.

Dominant language
Rust
Stars
8
Forks
5
Avg merge
11h 31m
Merged PRs (30d)
33

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from EnergySystemsModellingLab/MUSE2

All issues in EnergySystemsModellingLab/MUSE2

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.