Mac OS X setup guide

docs/getting-started/setup/mac.md

@@ -0,0 +1,39 @@
+---
+layout: getting_started
+title: Getting Started - Setting up Mac OS X
+---
+# Mac OS X
+
+## Built-in
+
+Mac OS X actually comes with Ruby and RubyGems built straight into the
+operating system already. These installations work with Vagrant if you
+want the "quick and easy setup." If this is the case, just head back to
+the [getting started overview page](/docs/getting-started/index.html)
+and continue with the guide!
+
+## MacPorts
+
+Generally, Ruby developers in general prefer to use [MacPorts](http://www.macports.org/) to install
+a more up-to-date and unmodified version of Ruby and RubyGems rather
+than relying on the stock OS X install.
+
+First, install [MacPorts](http://www.macports.org/) which is a simple
+`dmg` file which is downloaded from their site. Be sure to follow their
+instructions on setting up the `PATH` variable, if necessary (the installer
+actually automatically does this on the more recent versions of MacPorts).
+
+Next, install Ruby and RubyGems with a single command:
+
+{% highlight bash %}
+$ sudo port install ruby rb-rubygems
+{% endhighlight %}
+
+And you'll probably want to update your RubyGems installation, since
+MacPorts's is often out of date:
+
+{% highlight bash %}
+$ sudo gem update --system
+{% endhighlight %}
+
+And now your system is prepped and ready to go.

docs/getting-started/setup/ubuntu.md

@@ -0,0 +1,7 @@
+---
+layout: getting_started
+title: Getting Started - Setting up Ubuntu
+---
+# Ubuntu
+
+Coming soon.

docs/getting-started/setup/windows.md

@@ -1,6 +1,6 @@
 ---
 layout: getting_started
-title: Windows
+title: Getting Started - Setting up Windows
 ---
 # Windows