@@ -111,21 +111,21 @@ distribution of the crate itself, so a permissively-licensed crate should
111
111
generally only depend on permissively-licensed crates.
112
112
113
113
<a id =" c-msrv " ></a >
114
- ## Crate has a MSRV policy (C-MSRV)
114
+ ## Crate has an MSRV policy (C-MSRV)
115
115
116
116
A crate should clearly document its Minimal Supported Rust Version:
117
117
118
118
* Which versions versions of Rust are supported now?
119
119
* Under what conditions is MSRV increased?
120
- * How MSRV increases are reflected in the semver version of the crate?
120
+ * How are MSRV increases reflected in the semver version of the crate?
121
121
122
- MSRV should be tested in CI.
122
+ Compliance with a crate’s stated MSRV should be tested in CI.
123
123
124
- The API guidelines tentatively suggest that, for libraries, MSRV increase should
124
+ The API guidelines tentatively suggest that, for libraries, an MSRV increase should
125
125
* not* be considered a semver-breaking change. Specifically, when increasing
126
126
MSRV:
127
127
128
- * for crates past ` 1.0.0 ` increment minor version (` 1.1.3 ` -> ` 1.2.0 ` ),
128
+ * for crates past ` 1.0.0 ` , increment minor version (` 1.1.3 ` -> ` 1.2.0 ` ),
129
129
* for crates before ` 1.0.0 ` , increment patch version (` 0.1.3 ` -> ` 0.1.4 ` ).
130
130
131
131
This reduces the amount of ecosystem-wide work for MSRV upgrades and prevents
@@ -135,13 +135,13 @@ combinations of library and compiler versions, at the cost of breaking `cargo
135
135
update` workflow for older compilers.
136
136
137
137
However, do not increase MSRV without a good reason, and, if possible, batch
138
- MSRV increases with sevmer -breaking changes.
138
+ MSRV increases with semver -breaking changes.
139
139
140
- Nonetheless, some crates intentionally choose to treat MSRV increase as a semver
140
+ Nonetheless, some crates intentionally choose to treat MSRV increases as a semver
141
141
breaking change. This is also a valid strategy, but it is not recommended as the
142
142
default choice.
143
143
144
- To reliably test MSRV on CI, use a dedicated Cargo.lock file with dependencies
144
+ To reliably test MSRV on CI, use a dedicated ` Cargo.lock ` file with dependencies
145
145
pinned to minimal versions:
146
146
147
147
``` bash
0 commit comments