From 584d1b3524f290ac6d2c8f5976b1d4751a18c36f Mon Sep 17 00:00:00 2001
From: Veeti Haapsamo <veeti.haapsamo@gmail.com>
Date: Wed, 14 Nov 2018 01:07:41 -0800
Subject: [PATCH] Improve Getting Started: macOS instructions

---
 info/getting_started.md | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/info/getting_started.md b/info/getting_started.md
index fb37b7799c1..7eddd51dd23 100644
--- a/info/getting_started.md
+++ b/info/getting_started.md
@@ -1,18 +1,17 @@
 # Getting Started
 
+## macOS Dependencies
+
+Install the newest XCode from the App Store. This installs the required `metal` developer tools.
+
 ## Vulkan Dependencies
 
 First, install the x11 and Vulkan dev libraries.
 
-For Fedora
-
 ```bash
+# Fedora
 sudo dnf install -y libX11-devel vulkan
-```
-
-For Ubuntu
-
-```bash
+# Ubuntu
 sudo apt install -y libx11-dev libvulkan-dev libxcb1-dev xorg-dev
 ```
 
@@ -27,7 +26,11 @@ To run an example, simply use `cargo run` and specify the backend with `--featur
 ```bash
 git clone https://github.com/gfx-rs/gfx
 cd gfx/examples
+# macOS
+cargo run --bin quad --features metal
+# vulkan
 cargo run --bin quad --features vulkan
+# Windows
 cargo run --bin compute --features dx12 1 2 3 4
 ```