Merge pull request #2564 from mboersma/simpler-install-deisctl

docs(install-deisctl): remove extra installer links and simplify doc

Author: mboersma

docs/installing_deis/install-deisctl.rst

@@ -9,20 +9,20 @@ Install deisctl
 The Deis Control Utility, or ``deisctl`` for short, is a command-line client used to configure and
 manage the Deis Platform.
 
-Building from Installer
------------------------
+Run the Installer
+-----------------
 
-To install the latest version of deisctl, change to the directory where you would like to install
-the binary. Then, install the Deis Control Utility by downloading and running the install script
-with the following command:
+Change to the directory where you would like the ``deisctl`` binary to be installed, then download
+and run the latest installer:
 
 .. code-block:: console
 
     $ cd ~/bin
     $ curl -sSL http://deis.io/deisctl/install.sh | sh -s 1.0.1
 
-This installs deisctl to the current directory, and refreshes the Deis systemd unit files used to
-schedule the components. Link it to /usr/local/bin, so it will be in your PATH:
+This installs ``deisctl`` version 1.0.1 to the current directory, and downloads the matching
+Deis systemd unit files used to schedule the components. Link ``deisctl`` into /usr/local/bin, so
+it will be in your ``$PATH``:
 
 .. code-block:: console
 
@@ -44,22 +44,12 @@ are available.
     Always use a version of ``deisctl`` that matches the Deis release.
     Verify this with ``deisctl --version``.
 
-Builds are hosted on an S3 bucket at this URL format:
-
-``https://s3-us-west-2.amazonaws.com/opdemand/deisctl-<VERSION>-<darwin|linux>-amd64.run``
-
-For example, the deisctl release for Deis version 1.0.1 can be downloaded here:
-
-.. image:: download-linux-brightgreen.svg
-   :target: https://s3-us-west-2.amazonaws.com/opdemand/deisctl-1.0.1-linux-amd64.run
-
-.. image:: download-osx-brightgreen.svg
-   :target: https://s3-us-west-2.amazonaws.com/opdemand/deisctl-1.0.1-darwin-amd64.run
 
 Building from Source
 --------------------
 
-If you want to install from source, ensure you have `godep`_ installed and run:
+To build ``deisctl`` locally, first :ref:`get the source <get_the_source>`, ensure
+you have `godep`_ installed, and run:
 
 .. code-block:: console
 
@@ -71,5 +61,11 @@ You can then move or link the client so it will be in your path:
 
 	$ sudo ln -fs $PWD/deisctl/deisctl /usr/local/bin/deisctl
 
+.. note::
+
+    Remember to run ``deisctl refresh-units`` or to set ``$DEISCTL_UNITS`` to an appropriate
+    directory if you do not use the ``deisctl`` installer. Run the command
+    ``deisctl help refresh-units`` for more information.
+
 
 .. _`godep`: https://github.com/tools/godep