languages/dart-sdk
languages/dart-sdk
1
0
Fork 0
mirror of https://github.com/dart-lang/sdk synced 2024-07-08 20:16:39 +00:00
Code Issues Projects Releases Wiki Activity

update breaking change policy

Browse Source 
Closes https://github.com/dart-lang/sdk/pull/48463

GitOrigin-RevId: c711f1456983b39f2b76ab1724e7373da45490ed
Change-Id: I1208cb437cd41939ab4d3c2842bb681cb1be3f33
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/234104
Reviewed-by: Alexander Thomas <athom@google.com>
Commit-Queue: Alexander Thomas <athom@google.com>
This commit is contained in:
Kevin Chisholm 2022-02-24 09:17:23 +00:00 committed by Alexander Thomas
parent 494b45d453
commit 20b2a6bd52
1 changed files with 9 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/process/breaking-changes.md
View File

@ -29,7 +29,7 @@ abide by the following basic conditions:
* Must contain no static analysis **errors**.
* Must not rely on a certain runtime **error** being thrown (in other words,
* Must not rely on a certain runtime **error** being thrown (in other words,
a new SDK might throw fewer errors than an old SDK).
* Must access libraries via the public API (for example, must not reach into
@ -45,6 +45,13 @@ abide by the following basic conditions:
Compatibility is only considered between stable releases (i.e. releases from the
[Dart stable channel](https://dart.dev/tools/sdk/archive#stable-channel)).
## Breaking change implementation timing
To avoid shipping features that have not been thoroughly vetted, we implement a
policy of not including breaking changes in the final beta before a release.
Breaking changes must be included in the beta before the final beta to be
considered for the next stable release.
## Breaking change notification
Anyone wishing to make a breaking change to Dart is expected to perform the
@ -76,7 +83,7 @@ to a change being released in a dev channel release.
* A request that developers may leave comments in the linked issue, if this
breaking change poses a severe problem.
Once you have sent the announce email, please let devoncarew@ know in order
Once you have sent the announce email, please let kevinjchisholm@ know in order
to start the review and approval process.
### Step 2: Approval