docs(quick-start): add "Get the Source" instructions

Author: mboersma

docs/_includes/_get-the-source.rst

@@ -0,0 +1,24 @@
+Get the Source
+--------------
+
+The `source code`_ for Deis must be on your workstation to run the commands in
+this documentation. Download an archive file from the `releases page`_, or use
+``git`` to clone the repository:
+
+.. code-block:: console
+
+    $ git clone https://github.com/deis/deis.git
+    $ cd deis
+
+If you contribute to Deis or build components locally, use ``go get`` instead to
+clone the source code into your `$GOPATH`_:
+
+.. code-block:: console
+
+    $ go get -u -v github.com/deis/deis
+    $ cd $GOPATH/src/github.com/deis/deis
+
+
+.. _`source code`: https://github.com/deis/deis
+.. _`releases page`: https://github.com/deis/deis/releases
+.. _`$GOPATH`: http://golang.org/doc/code.html#GOPATH

docs/installing_deis/aws.rst

@@ -8,7 +8,8 @@ Amazon AWS
 
 In this tutorial, we will show you how to set up your own 3-node cluster on Amazon Web Services.
 
-Please refer to the scripts in `contrib/ec2`_ while following this documentation.
+Please :ref:`get the source <get_the_source>` and refer to the scripts in `contrib/ec2`_
+while following this documentation.
 
 
 Install the AWS Command Line Interface

docs/installing_deis/baremetal.rst

@@ -6,8 +6,12 @@
 Bare Metal
 ==========
 
-Deis clusters can be provisioned anywhere `CoreOS`_ can, including on your own hardware. To get
-CoreOS running on raw hardware, you can boot with `PXE`_ or `iPXE`_ - this will boot a CoreOS
+Deis clusters can be provisioned anywhere `CoreOS`_ can, including on your own hardware.
+
+Please :ref:`get the source <get_the_source>` and refer to the scripts in `contrib/bare-metal`_
+while following this documentation.
+
+To get CoreOS running on raw hardware, you can boot with `PXE`_ or `iPXE`_ - this will boot a CoreOS
 machine running entirely from RAM. Then, you can `install CoreOS to disk`_.
 
 .. important::
@@ -146,6 +150,7 @@ disk. Add the following block to the ``write_files`` section:
           options single-request
 
 
+.. _`contrib/bare-metal`: https://github.com/deis/deis/tree/master/contrib/bare-metal
 .. _`cluster size`: https://github.com/coreos/etcd/blob/master/Documentation/optimal-cluster-size.md
 .. _`CoreOS`: https://coreos.com/
 .. _`install CoreOS to disk`: https://coreos.com/docs/running-coreos/bare-metal/installing-to-disk/

docs/installing_deis/digitalocean.rst

@@ -8,6 +8,10 @@ DigitalOcean
 
 In this tutorial, we will show you how to set up your own 3-node cluster on DigitalOcean.
 
+Please :ref:`get the source <get_the_source>` and refer to the scripts in `contrib/digitalocean`_
+while following this documentation.
+
+
 Prerequisites
 -------------
 
@@ -140,6 +144,7 @@ Now that you've finished provisioning a cluster, please refer to :ref:`install_d
 start installing the platform.
 
 
+.. _`contrib/digitalocean`: https://github.com/deis/deis/tree/master/contrib/digitalocean
 .. _`docl`: https://github.com/nathansamson/docl#readme
 .. _`Deis Control Utility`: https://github.com/deis/deis/tree/master/deisctl#readme
 .. _`DNS control panel`: https://cloud.digitalocean.com/domains

docs/installing_deis/gce.rst

@@ -8,6 +8,9 @@ Google Compute Engine
 
 Let's build a Deis cluster in Google's Compute Engine!
 
+Please :ref:`get the source <get_the_source>` and refer to the scripts in `contrib/gce`_
+while following this documentation.
+
 
 Prerequisites
 -------------
@@ -280,6 +283,6 @@ start installing the platform.
 
 It works! Enjoy your Deis cluster in Google Compute Engine!
 
-
+.. _`contrib/gce`: https://github.com/deis/deis/tree/master/contrib/gce
 .. _`Google Cloud SDK`: https://developers.google.com/compute/docs/gcutil/#install
 .. _`Google Developer Console`: https://console.developers.google.com/project

docs/installing_deis/quick-start.rst

@@ -7,6 +7,11 @@ Quick Start
 These steps will help you provision a Deis cluster.
 
 
+.. _get_the_source:
+
+.. include:: ../_includes/_get-the-source.rst
+
+
 .. _generate_ssh_key:
 
 Generate an SSH key

docs/installing_deis/rackspace.rst

@@ -7,8 +7,10 @@ Rackspace
 =========
 
 We'll mostly be following the `CoreOS on Rackspace`_ guide. You'll need to have a sane python
-environment with ``pip`` already installed (``sudo easy_install pip``). Please refer to the scripts
-in `contrib/rackspace`_ while following this documentation.
+environment with ``pip`` already installed (``sudo easy_install pip``).
+
+Please :ref:`get the source <get_the_source>` and refer to the scripts in `contrib/rackspace`_
+while following this documentation.
 
 
 Install supernova

docs/installing_deis/vagrant.rst

@@ -9,6 +9,9 @@ Vagrant
 `Vagrant`_ is a tool for building complete development environments with a focus on automation.
 This guide demonstrates how you can stand up a Deis cluster for development purposes using Vagrant.
 
+Please :ref:`get the source <get_the_source>` and refer to the ``Vagrantfile``
+while following this documentation.
+
 
 Install Prerequisites
 ---------------------