Updated per reviews

dart-lang · Jan 19, 2024 · b6d586a · b6d586a
1 parent 4b8f51b
commit b6d586a
Show file tree

Hide file tree

Showing 2 changed files with 186 additions and 76 deletions.
diff --git a/src/_data/macos.json b/src/_data/macos.json
@@ -0,0 +1,107 @@
+[
+    {
+        "cycle":"14",
+        "codename":"Sonoma",
+        "releaseDate":"2023-09-26",
+        "eol":false,
+        "latest":"14.2.1",
+        "latestReleaseDate":"2023-12-19",
+        "link":"https://support.apple.com/HT213895",
+        "lts":false
+    },
+    {
+        "cycle":"13",
+        "codename":"Ventura",
+        "releaseDate":"2022-10-24",
+        "eol":false,
+        "latest":"13.6.3",
+        "latestReleaseDate":"2023-12-11",
+        "link":"https://support.apple.com/HT213268",
+        "lts":false
+    },
+    {
+        "cycle":"12",
+        "codename":"Monterey",
+        "releaseDate":"2021-10-25",
+        "eol":false,
+        "latest":"12.7.2",
+        "latestReleaseDate":"2023-12-11",
+        "link":"https://support.apple.com/HT212585",
+        "lts":false
+    },
+    {
+        "cycle":"11",
+        "codename":"Big Sur",
+        "releaseDate":"2020-11-12",
+        "eol":"2023-09-26",
+        "latest":"11.7.10",
+        "latestReleaseDate":"2023-09-11",
+        "link":"https://support.apple.com/HT211896",
+        "lts":false
+    },
+    {
+        "cycle":"10.15",
+        "codename":"Catalina",
+        "releaseDate":"2019-10-07",
+        "eol":"2022-09-12",
+        "latest":"10.15.7",
+        "latestReleaseDate":"2020-09-24",
+        "link":"https://support.apple.com/HT210642",
+        "lts":false
+    },
+    {
+        "cycle":"10.14",
+        "codename":"Mojave",
+        "releaseDate":"2018-09-24",
+        "eol":"2021-10-25",
+        "latest":"10.14.6",
+        "latestReleaseDate":"2019-07-22",
+        "lts":false
+    },
+    {
+        "cycle":"10.13",
+        "codename":"High Sierra",
+        "releaseDate":"2017-09-25",
+        "eol":"2020-12-01",
+        "latest":"10.13.6",
+        "latestReleaseDate":"2018-07-09",
+        "lts":false
+    },
+    {
+        "cycle":"10.12",
+        "codename":"Sierra",
+        "releaseDate":"2016-09-20",
+        "eol":"2019-10-01",
+        "latest":"10.12.6",
+        "latestReleaseDate":"2017-07-19",
+        "lts":false
+    },
+    {
+        "cycle":"10.11",
+        "codename":"El Capitan",
+        "releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
+        "releaseDate":"2015-09-30",
+        "eol":"2018-12-01",
+        "latest":"10.11.6",
+        "latestReleaseDate":"2016-07-18",
+        "lts":false
+    },
+    {
+        "cycle":"10.10",
+        "releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
+        "codename":"Yosemite",
+        "releaseDate":"2014-10-16",
+        "eol":"2017-08-01",
+        "latest":"10.10.5",
+        "latestReleaseDate":"2015-08-13",
+        "lts":false
+    },
+    {
+        "cycle":"10.9",
+        "releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
+        "codename":"Mavericks",
+        "releaseDate":"2013-10-22",
+        "eol":"2016-12-01",
+        "latest":"10.9.5",
+        "latestReleaseDate":"2014-09-17",
+        "lts":false}]
diff --git a/src/get-dart/index.md b/src/get-dart/index.md
@@ -1,35 +1,28 @@
 ---
 title: Get the Dart SDK
 description: Get the libraries and command-line tools that you need to develop Dart web, command-line, and server apps.
+channel-list: [Stable, Beta, Dev]
 js:
 - url: /assets/js/get-dart/install.js
   defer: true
 ---
 
 This page describes how to download the Dart SDK.
-The Dart SDK has the libraries and command-line tools that you need to develop
+The Dart SDK includes the libraries and command-line tools to develop
 Dart command-line, server, and non-Flutter web apps.
-For details, see the [Dart SDK overview](/tools/sdk).
+
+To learn more about the SDK, check out the [Dart SDK overview](/tools/sdk).
 
 ## Installing the Dart SDK {#install}
 
-As the following instructions show,
-you can use a package manager
-to easily install and update a stable channel Dart SDK.
-Alternatively, you can
-[build the SDK from source][],
-grab a [Dart Docker image][], or
-install from [any release channel](#release-channels) by
-[downloading the SDK as a zip file][].
+To install and update a stable channel Dart SDK,
+use a package manager.
+
 {% comment %}
 NOTE to editors: Keep the zip file link as the last thing in the paragraph,
 so it's easy to find (but not more tempting than package managers).
 {% endcomment %}
 
-*Note*: The Flutter SDK includes the full Dart SDK,
-and has Dart's [`dart`](/tools/dart-tool) command-line interface
-in its `bin` folder.
-
 {{site.alert.warn}}
   {% include_relative archive/_sdk-terms.md %}
 {{site.alert.end}}
@@ -49,90 +42,100 @@ in its `bin` folder.
 {% include_relative _mac.md %}
 </div>
 
-## System requirements
+Other options to install Dart include
+[building the SDK from source][build-source],
+using a [Dart Docker image][], or
+installing from [any release channel](#release-channels) by
+[downloading the SDK as a zip file][download].
 
-The Dart SDK is supported on Windows, Linux, and macOS.
+{{site.alert.note}}
+The [Flutter SDK][flutter] includes the full Dart SDK.
+Flutter installs place Dart's [`dart`](/tools/dart-tool)
+command-line interface in its `bin` directory.
+{{site.alert.end}}
 
-### Windows
+## System requirements
 
-* **Supported versions:** Windows 10 and 11.
-* **Supported architectures:** x64, IA32, ARM64.<br>
-  Support for ARM64 is in preview, and is available only in the dev and beta channels.
+The Windows, Linux, and macOS support the Dart SDK.
 
-### Linux
+### Supported architectures
 
-* **Supported versions:** [Debian stable][] and [Ubuntu LTS][] under standard support.
-* **Supported architectures:** x64, IA32, ARM64, ARM, RISC-V (RV64GC).<br>
-  Support for RISC-V is in preview, and is available only in the dev and beta channels.
+| Platform | x86 | x64 | ARM | ARM64     | RISC-V    |
+|----------|-----|-----|-----|-----------|-----------|
+| Windows  | Yes | Yes | No  | Dev, Beta | No        |
+| Linux    | Yes | Yes | Yes | Yes       | Dev, Beta |
+| macOS    | No  | Yes | No  | Yes       | No        |
+{:.table .table-striped}
 
-### macOS
+### Supported operating systems
 
-* **Supported versions:** Latest three major versions.
-Dart supports the following macOS versions as of November 2023:
-  - macOS 12 (Monterey)
-  - macOS 13 (Ventura)
-  - macOS 14 (Sonoma)
-* **Supported architectures:** x64, ARM64.
+| Platform | OS Versions                              |
+|----------|------------------------------------------|
+| Windows  | 10, 11                                   |
+| Linux    | [Debian stable][], [Ubuntu LTS][]        |
+| macOS    | {% for version in site.data.macos %}{% if version.eol == true %}{% break %}{%- else -%}{{version.cycle}} ({{version.codename}}){% endif %},{% endfor %} |
+{:.table .table-striped}
 
-## About release channels and version strings {#release-channels}
+## Release channels and version strings {#release-channels}
 
-The Dart SDK has three release channels:
+All Dart versions follow [semantic versioning][semvar].
 
-### Stable channel
-Dart deploys a release to the _stable_ channel about every three months.
-The current stable version is  `[calculating]`{:.build-rev-stable}.
+The Dart SDK has three release channels:
+**stable** (production), **beta** (preview), and **dev** (latest).
+
+{% for channel in page.channel-list %}
+{% assign chnl = channel | downcase -%}
+
+{% assign current="`[calculating]`{:.build-rev-" | append: chnl | append: "}" %}
+{% case chnl %}
+{% when 'stable' %}
+{% assign verstring = "`x.y.z`" %}
+{% assign examples = "`1.24.3` and `2.1.0`" %}
+{% when 'beta' %}
+{% assign verstring = "`x.y.z-a.b.beta`" %}
+{% assign examples = "`2.8.0-20.11.beta` and `3.3.0-205.1.beta`" %}
+{% assign verdesc = "pre-release" %}
+{% when 'dev' %}
+{% assign verstring = "`x.y.z-a.b.dev`" %}
+{% assign examples = "`2.8.0-20.11.dev` and `3.2.12-15.33.dev`" %}
+{% assign verdesc = "development" %}
+{% endcase %}
+
+### {{channel}} channel
+
+Dart publishes a new release to the *{{chnl}}* channel about every three months.
+The current {{chnl}} version is {{current}}.
 
 Use stable channel releases for production environments.
 
-Versioning for releases in stable channel of the Dart SDK follows a `x.y.z` format.
-The version strings resemble `1.24.3` and `2.1.0`.
-This format consists of three dot-separated integers without hyphens or letters.
-The versions include the major version (`x`), 
-then the minor version (`y`), and then the patch version (`z`).
-
-### Beta channel
-Dart releases a build to the _preview_ channel about every month.
-The current beta version is  `[calculating]`{:.build-rev-beta}.
-
-These beta channel releases preview features intended for the stable channel.
-Use releases in the beta channel to test new features or
-test compatibility with future releases.
-Don’t use beta releases for production environments. 
+**{{channel}}** channel release version strings follow a {{verstring}} format:
 
-Versioning for releases in the **beta** channel of the Dart SDK
-follows the `x.y.z-a.b.beta` format.
-Version strings resemble `2.8.0-20.11.beta`.
-The part before the hyphen follows the stable version format.
-The part after the hyphen adds the pre-release version (`a`),
-then the pre-release patch version (`b`), and then the channel (`beta`).
+* `x` : major version
+* `y` : minor version
+* `z` : patch version
+{% if chnl != 'stable' %}
+* `a` : {{verdesc}} version
+* `b` : {{verdesc}} patch version
+{% endif %}
 
-### Dev
-Dart releases a build to the **dev** channel about twice a week.
-The current dev version is  `[calculating]`{:.build-rev-dev}.
+Examples of {{chnl}} channel version strings include {{example}}.
 
-These dev channel builds include the most recent codebase with latest changes.
-These builds may be broken, have no support,
-and may contain unvetted breaking changes.
-
-Versioning for releases in the **dev** channel of the Dart SDK
-follows the `x.y.z-a.b.dev` format.
-Version strings resemble `2.8.0-20.11.dev`.
+{% endfor -%}
 
 ## How to get different channel releases
 
-You can get stable channel releases using
-the [instructions above](#install), or you can
-get stable, beta, or dev channel releases
-using [a package manager][] or [Dart Docker image][], or
-by [downloading the SDK as a zip file][].
+To get stable channel releases, use the [previous instructions](#install).
+To get stable, beta, or dev channel releases,
+use a [package manager][], use a [Dart Docker image][], or
+[download the SDK as a zip file][download].
 
-[SDK constraints]: /tools/pub/pubspec#sdk-constraints
-[build the SDK from source]: https://github.com/dart-lang/sdk/wiki/Building
-[Dart libraries]: /libraries
+[semvar]: /tools/pub/versioning#semantic-versions
+[build-source]: https://github.com/dart-lang/sdk/wiki/Building
 [Dart Docker image]: https://hub.docker.com/_/dart
-[downloading the SDK as a zip file]: /get-dart/archive
+[download]: /get-dart/archive
 [Debian stable]: https://www.debian.org/releases
 [Ubuntu LTS]: https://wiki.ubuntu.com/Releases
 [flutter]: https://flutter.dev/docs/get-started/install
+[package manager]: https://github.com/dart-lang/sdk/wiki/Installing-beta-and-dev-releases-with-brew,-choco,-and-apt-get
+[Dart libraries]: /libraries
 [site SDK version]: {{site.dart-api}}/{{site.data.pkg-vers.SDK.channel}}/{{site.data.pkg-vers.SDK.vers}}/index.html
-[a package manager]: https://github.com/dart-lang/sdk/wiki/Installing-beta-and-dev-releases-with-brew,-choco,-and-apt-get