You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is only to make the information that is already there clearer.
It does not attempt to update the information to be more current
(nor is this an attempt to advance any kind of policy changes).
- Improve consistency in use of code spans and italics.
- Have all references to "semver" be the hyperlink.
- Fix a minor spelling error.
- Very slightly adjust punctuation for clarity and consistency.
Copy file name to clipboardExpand all lines: STABILITY.md
+6-5
Original file line number
Diff line number
Diff line change
@@ -14,21 +14,22 @@ Please note that this guide isn't stable itself and may be adjusted to fit chang
14
14
-_workspace crate_
15
15
- A crate which is a member of this workspace and hence is stored in this repository
16
16
-_breaking change_
17
-
- A change in code that requires a `dependent crate` to adjust their code to fix compile errors.
17
+
- A change in code that requires a _dependent crate_ to adjust their code to fix compile errors.
18
18
-_release_
19
19
- A new version of a crate is published to crates.io
20
20
-_development version_
21
21
- A crate version whose _major_ version is 0.
22
22
-_release version_
23
23
- A crate version whose _major_ version is 1 or higher.
24
24
-_initial development phase_ (IDP)
25
-
- The phase of development leading up to producing a crate with a major version of 1 or greater, as per `semver`.
25
+
- The phase of development leading up to producing a crate with a major version of 1 or greater, as per [semver].
26
26
- Not to be confused with the term _pre-release_, which is used to indicate any release version prior to an actual release, like `1.1.0-beta.1`.
27
27
28
28
## Tiers
29
29
30
30
The project uses three stability tiers for all of its crates, and all crates use [semver] for their version numbers.
31
-
Tiers differ primarily in the time between breaking changes, which always have to be announced with `PRs` as per
31
+
32
+
Tiers differ primarily in the time between breaking changes, which always have to be announced with *PRs* as per
32
33
our [collaboration guide].
33
34
34
35
The following schematic helps to visualize what follows.
@@ -108,10 +109,10 @@ If there are additional breaking changes without a release, these push back the
108
109
### Tier 1: released apps and application crates
109
110
110
111
Released apps and application crates are marked with major version number 1 or above, like `2.3.0+21.06` and live in tier 1 _(->ST1)_,
111
-
with the build identifiers for year (`21`) and month `06` appended, based on the actual release year and month.
112
+
with the build identifiers for year (`21`) and month (`06`) appended, based on the actual release year and month.
112
113
113
114
Breaking changes are collected and may be released no more often than every 6 months by incrementing the major version number. If there are additional breaking changes,
114
-
these push bac the release date so that they can be tested at least for 3 months. For example, a breaking change happens in January 01, and another breaking change in February 15.
115
+
these push back the release date so that they can be tested at least for 3 months. For example, a breaking change happens in January 01, and another breaking change in February 15.
115
116
The earliest release date is July 1st. Had the second breaking change happened in April 01, the release date would have to be pushed to August 1st.
116
117
117
118
Intermediate pre-releases may be created at most every 4 weeks by appending `-alpha.X` where `X` is the sequential release number. These should help testing
0 commit comments