From 159e9615f8afcef9ebd539c87370b9ff7bd6a4a0 Mon Sep 17 00:00:00 2001 From: apiraino Date: Wed, 9 Sep 2026 11:58:32 +0200 Subject: [PATCH] Add a mention to docs about promoting and demoting platform support --- src/doc/rustc/src/platform-support.md | 6 ++++++ src/doc/rustc/src/target-tier-policy.md | 9 +++++++++ 2 files changed, 15 insertions(+) diff --git a/src/doc/rustc/src/platform-support.md b/src/doc/rustc/src/platform-support.md index 54d9885c93955..b6bf18a155051 100644 --- a/src/doc/rustc/src/platform-support.md +++ b/src/doc/rustc/src/platform-support.md @@ -15,6 +15,12 @@ the compiler what kind of output should be produced. Component availability is tracked [here](https://rust-lang.github.io/rustup-components-history/). +Support for targets can vary during their lifespan (a target con be promoted because the support +improves or can be demoted because lack of resources). Procedures for promoting and demoting targets +are documented at our [Forge documentation site][forge]. + +[forge]: https://forge.rust-lang.org/compiler/proposals-and-stabilization.html#targets + ## Tier 1 with Host Tools Tier 1 targets can be thought of as "guaranteed to work". The Rust project diff --git a/src/doc/rustc/src/target-tier-policy.md b/src/doc/rustc/src/target-tier-policy.md index ed725258fa7fb..e3da487da739b 100644 --- a/src/doc/rustc/src/target-tier-policy.md +++ b/src/doc/rustc/src/target-tier-policy.md @@ -4,6 +4,7 @@ * [General](#general) * [Adding a new target](#adding-a-new-target) +* [Promoting or demoting a target](#promoting-or-demoting-a-target) * [Tier 3 target policy](#tier-3-target-policy) * [Tier 2 target policy](#tier-2-target-policy) * [Tier 2 with host tools](#tier-2-with-host-tools) @@ -140,6 +141,14 @@ support for the target in `cc` and `libc`. [`rust-lang/rust`]: https://github.com/rust-lang/rust [rustc_dev_guide_add_target]: https://rustc-dev-guide.rust-lang.org/building/new-target.html +## Promoting or demoting a target + +Support for targets can vary during their lifespan (a target con be promoted because the support +improves or can be demoted because lack of resources). Procedures for promoting and demoting targets +are documented at our [Forge documentation site][forge]. + +[forge]: https://forge.rust-lang.org/compiler/proposals-and-stabilization.html#targets + ## Tier 3 target policy At this tier, the Rust project provides no official support for a target, so we