From c15501fc9b06f46a699bcded6d2e14c5c48af2db Mon Sep 17 00:00:00 2001
From: Chad Little <chad@phacility.com>
Date: Fri, 24 Feb 2017 16:34:32 -0800
Subject: [PATCH] Add clearer language and options to Arcanist install guides

Summary: Fixes T12315. Reworks the copy placement a little, adds more links.

Test Plan: Read in sandbox

Reviewers: epriestley

Reviewed By: epriestley

Subscribers: Korvin

Maniphest Tasks: T12315

Differential Revision: https://secure.phabricator.com/D17413
---
 src/docs/user/userguide/arcanist_mac_os_x.diviner    |  1 +
 src/docs/user/userguide/arcanist_quick_start.diviner | 11 +++++------
 src/docs/user/userguide/arcanist_windows.diviner     |  1 +
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/docs/user/userguide/arcanist_mac_os_x.diviner b/src/docs/user/userguide/arcanist_mac_os_x.diviner
index a34adfbf5d..d75df8b33b 100644
--- a/src/docs/user/userguide/arcanist_mac_os_x.diviner
+++ b/src/docs/user/userguide/arcanist_mac_os_x.diviner
@@ -9,6 +9,7 @@ You need to install:
 
   - PHP, which should be installed by default.
   - Arcanist itself, see @{article:Arcanist User Guide}.
+  or @{article:Arcanist Quick Start}
   - SVN, Git, or Mercurial.
 
 Then, configure:
diff --git a/src/docs/user/userguide/arcanist_quick_start.diviner b/src/docs/user/userguide/arcanist_quick_start.diviner
index 98633bfaef..743afe4a11 100644
--- a/src/docs/user/userguide/arcanist_quick_start.diviner
+++ b/src/docs/user/userguide/arcanist_quick_start.diviner
@@ -4,16 +4,15 @@
 Quick guide to getting Arcanist working for a new project.
 
 This is a summary of steps to install Arcanist, configure a project for use with
-it, and run `arc` to send changes for review.
-
-= Install Arcanist =
-
-For detailed instructions on installing Arcanist, see
-@{article:Arcanist User Guide}.
+it, and run `arc` to send changes for review. For detailed instructions on
+installing Arcanist, see @{article:Arcanist User Guide}. OS specific guides
+are also available.
 
   - For Mac OS X, see @{article:Arcanist User Guide: Mac OS X}.
   - For Windows, see @{article:Arcanist User Guide: Windows}.
 
+= Installing Arcanist =
+
 First, install dependencies:
 
   - Install PHP.
diff --git a/src/docs/user/userguide/arcanist_windows.diviner b/src/docs/user/userguide/arcanist_windows.diviner
index 150e4f3372..56fbfea318 100644
--- a/src/docs/user/userguide/arcanist_windows.diviner
+++ b/src/docs/user/userguide/arcanist_windows.diviner
@@ -17,6 +17,7 @@ into issues.
 You need to install:
 
   - Arcanist itself, see @{article:Arcanist User Guide}.
+  or @{article:Arcanist Quick Start}.
   - PHP (see "Detailed PHP Install Instructions" below).
   - SVN, Git, or Mercurial.