Update supported versions

dart-lang · Jan 30, 2024 · 8f5770f · 8f5770f
1 parent 5ac42d8
commit 8f5770f
Show file tree

Hide file tree

Showing 7 changed files with 383 additions and 139 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/_sass/site.scss b/src/_sass/site.scss
@@ -553,7 +553,7 @@ li.card {
   border-radius: 0;
   color: $site-color-body;
   margin-top: 1rem;
-  padding: 30px 30px;
+  padding: 1.5rem;
 
   i.material-icons {
     font-size: 20px;
@@ -569,7 +569,7 @@ li.card {
     background-color: #00000010;
   }
 
-  p:last-child {
+  p:last-child, li:last-child, ul:last-child, ol:last-child {
     margin-bottom: 0;
   }
 
@@ -884,3 +884,16 @@ body.obsolete {
     }
   }
 }
+
+/* -----------------------------------------
+  Headings in boxes
+ ----------------------------------------- */
+
+div h1:first-child,
+div h2:first-child,
+div h3:first-child,
+div h4:first-child,
+div h5:first-child,
+div h6:first-child {
+  margin-top: 0rem;
+}
diff --git a/src/get-dart/_linux.md b/src/get-dart/_linux.md
@@ -1,29 +1,85 @@
-If you're using Debian/Ubuntu on AMD64 (64-bit Intel), you can choose one of the
-following options, both of which can update the SDK automatically when new
-versions are released.
 
-* [Install using apt-get](#install-using-apt-get)
-* [Install a Debian package](#install-a-debian-package)
 
-#### Install using apt-get
+### System requirements
+{: .no_toc}
 
-Perform the following **one-time setup**:
+Dart supports the following hardware architectures and platform versions
+to develop and run Dart code on Linux.
 
-```terminal
-$ sudo apt-get update
-$ sudo apt-get install apt-transport-https
-$ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
-$ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list
-```
+#### Hardware architecture
+{: .no_toc}
+
+Dart supports the following CPU architectures on Linux.
+
+| Platform | x86 | x64 | ARM | ARM64     | RISC-V    |
+|----------|-----|-----|-----|-----------|-----------|
+| Linux    | Yes | Yes | Yes | Yes       | Dev, Beta |
+{:.table .table-striped}
+
+#### Operating system flavor and version
+{: .no_toc}
+
+Dart supports the [Debian stable][] and [Ubuntu LTS][] under standard
+support.
+
+| Platform | OS Versions                              |
+|----------|------------------------------------------|
+| Linux    | [Debian stable][], [Ubuntu LTS][]        |
+{:.table .table-striped}
+
+### Install using package manager
+{: .no_toc}
+
+Choose to install either using [apt-get](#install-using-apt-get)
+or downloading a [`.deb`](#install-a-debian-package) package.
+
+Both methods trigger an SDK update whenever Dart releases a new version.
+
+#### Install using `apt-get`
+{: .no_toc}
+
+Perform the following steps for the first install only.
 
-Then install the Dart SDK:
+1. Update the package index files and install the secure HTTP package.
+
+   ```terminal
+   $ sudo apt-get update && sudo apt-get install apt-transport-https
+   ```
+
+1. Download and add the Google Linux GPG public key.
+
+   ```terminal
+   $ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg  --dearmor -o /usr/share/keyrings/dart.gpg
+   ```
+
+1. Add the Dart package repository to your Linux system.
+
+   ```terminal
+   $ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list
+   ```
+
+Install the Dart SDK using [`sudo`][sudo].
 
 ```terminal
-$ sudo apt-get update
-$ sudo apt-get install dart
+$ sudo apt-get update && sudo apt-get install dart
 ```
 
 #### Install a Debian package
 
-Alternatively, download Dart SDK [as a Debian package](#){:.debian-link-stable}
-in the `.deb` package format.
+To install the Dart SDK as a Debian package (`*.deb`).
+
+1. Download the Dart SDK as a [Debian package](#){:.debian-link-stable}.
+
+1. Install the `*.deb` package using one of two methods:
+
+   * From a GUI, double-click the `.deb` file.
+
+   * From a terminal, run the following command:
+
+     ```terminal
+     $ sudo dpkg -i dart_3.2.6-1_amd64.deb
+     ```
+
+[sudo]: https://www.sudo.ws/
+[Debian stable]: https://www.debian.org/releases
+[Ubuntu LTS]: https://wiki.ubuntu.com/Releases
diff --git a/src/get-dart/_mac.md b/src/get-dart/_mac.md
@@ -1,42 +1,88 @@
-[Install Homebrew,](https://brew.sh)
-and then run the following commands:
+
+### System requirements
+{: .no_toc}
+
+Dart supports the following hardware architectures and platform versions
+to develop and run Dart code on macOS.
+
+#### Hardware architecture
+{: .no_toc}
+
+Dart supports the following CPU architectures.
+
+| Platform | x86 | x64 | ARM | ARM64 | RISC-V |
+|----------|-----|-----|-----|-------|--------|
+| macOS    | No  | Yes | No  | Yes   | No     |
+{:.table .table-striped}
+
+#### Operating system
+{: .no_toc}
+
+Dart supports the latest three major versions of macOS.
+
+| Platform | OS Versions                              |
+|----------|------------------------------------------|
+| macOS    | {% for version in site.data.macos %}{% if version.eol != false %}{% break %}{%- else -%}{{version.cycle}} ({{version.codename}}){% endif %}, {% endfor %} |
+{:.table .table-striped}
+
+### Install using Homebrew
+{: .no_toc}
+
+To install the Dart SDK, use [Homebrew][].
+
+Install Homebrew, then run the following commands.
 
 ```terminal
 $ brew tap dart-lang/dart
 $ brew install dart
 ```
 
-{{site.alert.important}}
-  Make sure the **Homebrew `bin` directory is in your `PATH`**. 
+### Verify PATH includes Homebrew
+{: .no_toc}
+
+  Verify that your `PATH` includes the **Homebrew `bin`.
   Setting up the path correctly makes it easier to use Dart SDK commands
-  such as `dart run` and `dart format`. 
-  For help configuring your path, 
+  such as `dart run` and `dart format`.
+  For help configuring your path,
   consult the [Homebrew FAQ.](https://docs.brew.sh/FAQ)
 {{site.alert.end}}
 
+### Upgrade using Homebrew
+{: .no_toc}
+
 To upgrade when a new release of Dart is available:
 
 ```terminal
 $ brew upgrade dart
 ```
 
-To switch between locally installed Dart releases, 
-first install the version you want to switch to if you haven't.
-For example, to install Dart 2.12:
+### Switch Dart versions
+{: .no_toc}
 
-```terminal
-$ brew install dart@2.12
-```
+To switch between locally installed Dart releases:
 
-Then to switch between versions, 
-unlink the current version and link the desired version.
+1. Install the version to which you want to switch.
 
-```terminal
-$ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>
-```
+   For example, to install Dart 3.1:
+
+   ```terminal
+   $ brew install dart@3.1
+   ```
+
+1. To switch between versions,
+   unlink the current version and link the desired version.
+
+   ```terminal
+   $ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>
+   ```
+
+### List installed Dart versions
+{: .no_toc}
 
 To see which versions of Dart you've installed:
 
 ```terminal
 $ brew info dart
 ```
+
+[Homebrew]: https://brew.sh