Skip to content

Commit 0e817a1

Browse files
committed
docs(ref): Clarify MSRV is generally minor
For the second time in the last week or two, I've seen the wording of cargo's semver documentation used to justify pushing back against treating MSRV bumps as minor changes. See time-rs/time#535 (comment) The current wording makes it sound like "major" is the default stance but the [general consensus seems to be around "minor"](rust-lang/api-guidelines#231). I held back from changing from "possibly major" to minor" for now as the above linked policy isn't official yet and it leaves it open for crates to treat it as major.
1 parent 13413c6 commit 0e817a1

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

src/doc/src/reference/semver.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1251,7 +1251,8 @@ projects that are using older versions of Rust. This also includes using new
12511251
features in a new release of Cargo, and requiring the use of a nightly-only
12521252
feature in a crate that previously worked on stable.
12531253

1254-
Some projects choose to allow this in a minor release for various reasons. It
1254+
It is generally recommended to treat this as a minor change, rather than as
1255+
a major change, for [various reasons][msrv-is-minor]. It
12551256
is usually relatively easy to update to a newer version of Rust. Rust also has
12561257
a rapid 6-week release cycle, and some projects will provide compatibility
12571258
within a window of releases (such as the current stable release plus N
@@ -1530,3 +1531,4 @@ document what your commitments are.
15301531
[struct literal]: ../../reference/expressions/struct-expr.html
15311532
[wildcard patterns]: ../../reference/patterns.html#wildcard-pattern
15321533
[unused_unsafe]: ../../rustc/lints/listing/warn-by-default.html#unused-unsafe
1534+
[msrv-is-minor]: https://github.com/rust-lang/api-guidelines/discussions/231

0 commit comments

Comments
 (0)