From 8114df5a3931263a22b3b2db319cc2481669981e Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Mon, 3 Mar 2025 14:03:39 -0600 Subject: [PATCH 1/4] Document the SDK release policy --- firebase.json | 1 + src/content/get-dart/index.md | 4 ++++ src/content/tools/sdk.md | 26 ++++++++++++++++++++++++++ 3 files changed, 31 insertions(+) diff --git a/firebase.json b/firebase.json index e50240d7ec..3b50b54aca 100644 --- a/firebase.json +++ b/firebase.json @@ -388,6 +388,7 @@ { "source": "/to/publish-from-github", "destination": "/tools/pub/automated-publishing#publishing-packages-using-github-actions", "type": 301 }, { "source": "/to/publish-with-service-account", "destination": "/tools/pub/automated-publishing#publishing-from-google-cloud-build", "type": 301 }, { "source": "/to/pubspec-overrides", "destination": "/tools/pub/dependencies#pubspec-overrides", "type": 301 }, + { "source": "/to/release-policy", "destination": "/tools/sdk#release-policy", "type": 301 }, { "source": "/to/sdk-constraint", "destination": "/tools/pub/pubspec#sdk-constraints", "type": 301 }, { "source": "/to/sdk-version-pinning", "destination": "https://github.com/dart-lang/sdk/blob/main/docs/Flutter-Pinned-Packages.md", "type": 301 }, { "source": "/to/web-debug-extension", "destination": "https://chromewebstore.google.com/detail/dart-debug-extension/eljbmlghnomdjgdjmbdekegdkbabckhm", "type": 301 }, diff --git a/src/content/get-dart/index.md b/src/content/get-dart/index.md index cffd38a190..4f01ee6664 100644 --- a/src/content/get-dart/index.md +++ b/src/content/get-dart/index.md @@ -11,6 +11,10 @@ This page describes how to download the Dart SDK. The Dart SDK includes the libraries and command-line tools that you need to develop Dart command-line, server, and web apps. +The Dart team supports only the latest stable release of the SDK. +For full details on the SDK release lifecycle and supported versions, +check out the [SDK release policy](/tools/sdk#release-policy). + To learn more about the Dart SDK, consult the [Dart SDK overview](/tools/sdk). :::tip diff --git a/src/content/tools/sdk.md b/src/content/tools/sdk.md index d6b7841bd7..71b5623cc6 100644 --- a/src/content/tools/sdk.md +++ b/src/content/tools/sdk.md @@ -42,6 +42,32 @@ The Dart SDK includes two directories: To learn more about the SDK, check out its [README file][readme]. +## Release policy + +The Dart team supports only the latest, stable version of the Dart SDK. +When a new major or minor version is released, +older versions are no longer supported. +For example, if `3.7.x` is the latest release, +it is supported until `3.8.0` or `4.0.0` is released, +whichever comes first. + +The Dart team provides fixes to critical issues and security problems as needed +through patch releases but only for the currently supported version. +For example, if `3.7.0` is the latest release, +a fix to a vulnerability might be issued in a `3.7.1` patch release. + +On average, the Dart team ships a new stable release every 3 months. +Patch releases to the currently supported version are shipped as needed. + +This policy ensures developers have access to +the latest features and security updates and that +the Dart team's efforts are focused on the most recent release. + +{% comment %} +TODO(parlough): Add a section discussing the breaking change policy +and link out to the breaking change index. +{% endcomment %} + ## Filing bugs and feature requests To see existing issues or create a new one, From d8a2ad5f7e9ef87c3e2efa974bbd8d82cae672f4 Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Mon, 3 Mar 2025 14:05:22 -0600 Subject: [PATCH 2/4] Use 'Support policy' term instead --- firebase.json | 2 +- src/content/get-dart/index.md | 2 +- src/content/tools/sdk.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/firebase.json b/firebase.json index 3b50b54aca..0e5a2164c4 100644 --- a/firebase.json +++ b/firebase.json @@ -388,7 +388,7 @@ { "source": "/to/publish-from-github", "destination": "/tools/pub/automated-publishing#publishing-packages-using-github-actions", "type": 301 }, { "source": "/to/publish-with-service-account", "destination": "/tools/pub/automated-publishing#publishing-from-google-cloud-build", "type": 301 }, { "source": "/to/pubspec-overrides", "destination": "/tools/pub/dependencies#pubspec-overrides", "type": 301 }, - { "source": "/to/release-policy", "destination": "/tools/sdk#release-policy", "type": 301 }, + { "source": "/to/sdk-support-policy", "destination": "/tools/sdk#support-policy", "type": 301 }, { "source": "/to/sdk-constraint", "destination": "/tools/pub/pubspec#sdk-constraints", "type": 301 }, { "source": "/to/sdk-version-pinning", "destination": "https://github.com/dart-lang/sdk/blob/main/docs/Flutter-Pinned-Packages.md", "type": 301 }, { "source": "/to/web-debug-extension", "destination": "https://chromewebstore.google.com/detail/dart-debug-extension/eljbmlghnomdjgdjmbdekegdkbabckhm", "type": 301 }, diff --git a/src/content/get-dart/index.md b/src/content/get-dart/index.md index 4f01ee6664..279c72c2ad 100644 --- a/src/content/get-dart/index.md +++ b/src/content/get-dart/index.md @@ -13,7 +13,7 @@ you need to develop Dart command-line, server, and web apps. The Dart team supports only the latest stable release of the SDK. For full details on the SDK release lifecycle and supported versions, -check out the [SDK release policy](/tools/sdk#release-policy). +check out the [SDK support policy](/tools/sdk#support-policy). To learn more about the Dart SDK, consult the [Dart SDK overview](/tools/sdk). diff --git a/src/content/tools/sdk.md b/src/content/tools/sdk.md index 71b5623cc6..42d502c93b 100644 --- a/src/content/tools/sdk.md +++ b/src/content/tools/sdk.md @@ -42,7 +42,7 @@ The Dart SDK includes two directories: To learn more about the SDK, check out its [README file][readme]. -## Release policy +## Support policy The Dart team supports only the latest, stable version of the Dart SDK. When a new major or minor version is released, From a0017836fb941b464aee73882e13e82608cb50ab Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Mon, 3 Mar 2025 14:11:48 -0600 Subject: [PATCH 3/4] Adjust reasoning clause --- src/content/tools/sdk.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/tools/sdk.md b/src/content/tools/sdk.md index 42d502c93b..14551e57bb 100644 --- a/src/content/tools/sdk.md +++ b/src/content/tools/sdk.md @@ -59,9 +59,9 @@ a fix to a vulnerability might be issued in a `3.7.1` patch release. On average, the Dart team ships a new stable release every 3 months. Patch releases to the currently supported version are shipped as needed. -This policy ensures developers have access to -the latest features and security updates and that -the Dart team's efforts are focused on the most recent release. +This policy helps ensure Dart developers have access to +a stable and reliable platform that continues to +evolve with new features and improvements. {% comment %} TODO(parlough): Add a section discussing the breaking change policy From b8bdeeb3d61560eacb298da172491ddab18ae403 Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Mon, 3 Mar 2025 14:31:00 -0600 Subject: [PATCH 4/4] Clarify latest release --- src/content/tools/sdk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/tools/sdk.md b/src/content/tools/sdk.md index 14551e57bb..51c32eae40 100644 --- a/src/content/tools/sdk.md +++ b/src/content/tools/sdk.md @@ -53,7 +53,7 @@ whichever comes first. The Dart team provides fixes to critical issues and security problems as needed through patch releases but only for the currently supported version. -For example, if `3.7.0` is the latest release, +For example, if `3.7.0` is the latest stable release, a fix to a vulnerability might be issued in a `3.7.1` patch release. On average, the Dart team ships a new stable release every 3 months.