Editing Sam's downloads page

src/site/_includes/downloads/_macos_section.html

Index: src/site/_includes/downloads/_macos_section.html
diff --git a/src/site/_includes/downloads/_macos_section.html b/src/site/_includes/downloads/_macos_section.html
new file mode 100644
index 0000000000000000000000000000000000000000..a170da862c5f8a2dc3183cb3f529c7a64f3e25db
--- /dev/null
+++ b/src/site/_includes/downloads/_macos_section.html
@@ -0,0 +1,72 @@
+First install Dart, and then choose your editor.
+(Don't care which editor you use?
+Skip to [Step 2](#step-2-pick-an-editor-mac) and choose **Dart Editor**,
+which includes Dart.)
+
+
+## Step 1: Install Dart
+
+We recommend using [Homebrew](http://brew.sh/) to manage your Dart
+installation.
+To install Dart, run:
+
+{% prettify huge %}
+$ brew tap dart-lang/dart
+$ brew install dart dartium
+{% endprettify %}
+
+The **dart** package contains the [Dart SDK](/tools/sdk/),
+which includes the Dart VM, libraries, and command-line Dart tools such as
+[dart](/tools/dart-vm/), [dart2js](/tools/dart2js/),
+[dartanalyzer](/docs/dart-up-and-running/contents/ch04-tools-dart_analyzer.html),
+[pub](/tools/pub/), and [docgen](docgen/).
+
+The **dartium** package contains a special build of Chromium
+(nicknamed [Dartium](/tools/dartium/)) that includes a Dart VM.
+Use it to test and
+debug Dart web apps without first compiling them to JavaScript.
+
+<aside class="alert alert-info" markdown="1">
+**Writing server-side code?**
+If you don't write Dart web apps,
+you don't need to download `dartium`.

[srawlins, 2014/11/05 18:38:22]

I think in this context, with Homebrew, 'download' should be 'install'.

[Kathy Walrath, 2014/11/05 19:52:10]

Done.

+Just `brew install dart`.

[srawlins, 2014/11/05 18:38:22]

IMHO this isn't necessary.

[Kathy Walrath, 2014/11/05 19:52:10]

Done.

+</aside>
+
+To update the software later, run:
+
+{% prettify huge %}
+$ brew upgrade dart dartium
+{% endprettify %}
+
+
+### Manual download
+
+An alternative to using Homebrew or Dart Editor

[srawlins, 2014/11/05 18:38:22]

"or Dart Editor": Dart Editor hasn't been introduced yet. This might be
confusing here.

[Kathy Walrath, 2014/11/05 19:52:10]

It's mentioned at the top in bold font, so I hoped that would be clue enough,
even though it's easy to miss.

+is downloading Dart manually.
+You'll need to perform the following steps
+periodically to update your software.
+
+1. <a
+    data-bits="32" data-os="macos" data-tool="sdk"
+    class="download-link"
+    href="{{ site.custom.downloads.dartarchive-stable-url-prefix }}/latest/sdk/dartsdk-macos-ia32-release.zip">
+  Download the Dart SDK.</a>
+  If you need a bigger heap or access to much more memory, download the
+<a
+    data-bits="64" data-os="macos" data-tool="sdk"
+    class="download-link"
+    href="{{ site.custom.downloads.dartarchive-stable-url-prefix }}/latest/sdk/dartsdk-macos-x64-release.zip">
+  64-bit Dart SDK</a>.
+  Unzip the downloaded file to get the SDK.
+
+2. Add `<sdk>/bin` to your `PATH`.
+
+3. If you're developing a web app, <a
+    data-bits="32" data-os="macos" data-tool="dartium"
+    class="download-link"
+    href="{{ site.custom.downloads.dartarchive-stable-url-prefix }}/latest/dartium/dartium-macos-ia32-release.zip">
+  download Dartium</a>.
+  Unzip it to get special version of Chromium with the Dart VM.
+  This binary expires after 12 weeks. When that happens,
+  you need to download a new copy to continue using Dartium.