ref(docs): move "make disco-url" section inline to each install doc

Author: mboersma

docs/_includes/_generate-discovery-url.rst

@@ -0,0 +1,13 @@
+A discovery URL links `etcd`_ instances together by storing their peer
+addresses and metadata under a unique identifier. Run this command from the root
+of the repository to generate a ``contrib/coreos/user-data`` file with a new
+discovery URL:
+
+.. code-block:: console
+
+    $ make discovery-url
+
+Required scripts are supplied in this ``user-data`` file, so do not provision a
+Deis cluster without running ``make discovery-url``.
+
+.. _`etcd`: https://github.com/coreos/etcd

docs/installing_deis/aws.rst

@@ -71,17 +71,7 @@ Deis clusters of less than 3 nodes are unsupported.
 Generate a New Discovery URL
 ----------------------------
 
-To get started with provisioning Deis, we will need to generate a new Discovery URL. Discovery URLs
-help connect `etcd`_ instances together by storing a list of peer addresses and metadata under a
-unique address. You can generate a new discovery URL for use in your platform by
-running the following from the root of the repository:
-
-.. code-block:: console
-
-    $ make discovery-url
-
-This will write a new discovery URL to the user-data file. Some convenience scripts are supplied in
-this user-data file, so it is mandatory for provisioning Deis.
+.. include:: ../_includes/_generate-discovery-url.rst
 
 
 Customize cloudformation.json

docs/installing_deis/baremetal.rst

@@ -39,7 +39,7 @@ Customize user-data
 Generate a New Discovery URL
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Please refer to :ref:`generate_discovery_url` for generating a new Discovery URL.
+.. include:: ../_includes/_generate-discovery-url.rst
 
 
 SSH Key

docs/installing_deis/digitalocean.rst

@@ -41,7 +41,8 @@ Generate SSH Key
 Generate a New Discovery URL
 ----------------------------
 
-Please refer to :ref:`generate_discovery_url` for generating a new Discovery URL.
+.. include:: ../_includes/_generate-discovery-url.rst
+
 
 Create CoreOS Droplets
 ----------------------

docs/installing_deis/quick-start.rst

@@ -26,16 +26,8 @@ Generate SSH Key
 Generate a New Discovery URL
 ----------------------------
 
-Discovery URLs help connect `etcd`_ instances together by storing a list of peer addresses and metadata under a
-unique address. You can generate a new discovery URL for use in your platform by
-running the following from the root of the repository:
+.. include:: ../_includes/_generate-discovery-url.rst
 
-.. code-block:: console
-
-    $ make discovery-url
-
-This will write a new discovery URL to the user-data file. Some essential scripts are supplied in
-this user-data file, so it is mandatory for provisioning Deis.
 
 Check System Requirements
 -------------------------
@@ -71,4 +63,3 @@ please refer to :ref:`install_deisctl` and :ref:`install_deis_platform`.
 
 
 .. _`CoreOS`: https://coreos.com/
-.. _`etcd`: https://github.com/coreos/etcd

docs/installing_deis/rackspace.rst

@@ -61,7 +61,7 @@ Tell supernova about the key pair and give it an identifiable name:
 Generate a New Discovery URL
 ----------------------------
 
-Please refer to :ref:`generate_discovery_url` for generating a new Discovery URL.
+.. include:: ../_includes/_generate-discovery-url.rst
 
 
 Choose number of instances

docs/installing_deis/vagrant.rst

@@ -34,7 +34,7 @@ Generate SSH Key
 Generate a New Discovery URL
 ----------------------------
 
-Please refer to :ref:`generate_discovery_url` for generating a new Discovery URL.
+.. include:: ../_includes/_generate-discovery-url.rst
 
 
 Boot CoreOS