From 6df2db360c12a02592a9f078cd2f85f735aa088d Mon Sep 17 00:00:00 2001 From: Josh Triplett Date: Sun, 28 Jun 2026 15:00:15 -0700 Subject: [PATCH] Note that the replacement functionality in `std` must be stable --- CONTRIBUTING.md | 10 ++++++++-- README.md | 6 +++--- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d7b7556..70c4d98 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -23,12 +23,18 @@ Standard-library replacements only. The dataset deliberately avoids "prefer this nicer crate instead" recommendations. Every entry is a checkable factual statement about `std`, never an opinion about a competing crate. +The functionality must have shipped in a stable Rust release. If the +functionality only exists in nightly or beta, go ahead and file a draft PR and +start the discussion period with the crate maintainer, but the PR should not +get merged until the functionality exists in stable Rust. + Two kinds of entries qualify: - **Full**: the crate's functionality is entirely available through a stable `std` API. -- **Partial**: the bulk of the crate's common use case has moved to `std`, but - not all of it. The `description` must spell out what is still missing. +- **Partial**: the bulk of the crate's common use case is available in stable + `std`, but not all of it. The `description` must spell out what is still + missing. Coverage is judged by the dominant use case. If only a small slice of a crate's purpose lives in `std`, it does not qualify. `itertools` is the canonical diff --git a/README.md b/README.md index ee8098b..3b4003e 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,8 @@ # std-replacement-data -A curated dataset of Rust crates whose functionality is now available in the -standard library. crates.io reads it to point out when `std` already covers -what the crate provides and where to find the equivalent API. +A curated dataset of Rust crates whose functionality is now available and +stable in the standard library. crates.io reads it to point out when `std` +already covers what the crate provides and where to find the equivalent API. Every entry is a checkable factual statement about `std`, never an opinion about a competing crate.