docs(scheduler): updated CLI instructions and developer docs

Author: mboersma

docs/developer/buildpack.rst

@@ -1,5 +1,5 @@
 :title: Deploying with Heroku Buildpacks on Deis
-:description: A howto on deploying applications using Heroku Buildpacks
+:description: How to deploy applications using Heroku Buildpacks
 
 Buildpacks
 ==========
@@ -52,10 +52,6 @@ push. For example:
     === classy-hardtack
     BUILDPACK_URL: https://github.com/bacongobbler/heroku-buildpack-jekyll
 
-.. note::
-
-    Setting config variables before your first deployment results in an error. See `issue
-    542`_ for more details.
 
 .. _`Java buildpack`: https://github.com/heroku/heroku-buildpack-java.git
 .. _`Ruby buildpack`: https://github.com/heroku/heroku-buildpack-ruby.git
@@ -70,4 +66,3 @@ push. For example:
 .. _`Perl buildpack`: https://github.com/miyagawa/heroku-buildpack-perl/tree/carton
 .. _`builder recipe`: https://github.com/opdemand/deis-cookbook/blob/master/recipes/builder.rb
 .. _`Deis cookbook`: https://github.com/opdemand/deis-cookbook.git
-.. _`issue 542`: https://github.com/opdemand/deis/issues/542

docs/developer/deploy-application.rst

@@ -16,7 +16,7 @@ Before deploying an application, all users must first authenticate against the D
 
 .. code-block:: console
 
-    $ deis login http://example.com
+    $ deis login http://example.com:8000
     username: deis
     password:
     Logged in as deis
@@ -30,7 +30,7 @@ create`` command to create a remote repository for you to push your application
 .. code-block:: console
 
     $ cd example-java-jetty    # change into your application's git root
-    $ deis create --formation=dev
+    $ deis create --cluster=dev
     Creating application... done, created peachy-waxworks
     Git remote deis added
 
@@ -43,7 +43,7 @@ you can use `our Dockerfile example`_.
 
 .. code-block:: console
 
-    ><> deis create --formation=dev
+    ><> deis create --cluster=dev
     Creating application... done, created owlish-huntress
     Git remote deis added
     ><> git push deis master

docs/developer/install-client.rst

@@ -3,12 +3,12 @@
 
 Install the Client
 ==================
-The Deis client allows you to interact with a Deis :ref:`Controller`.
-You'll need to install the client before you can use Deis.
+The Deis command-line interface (CLI), or client, allows you to interact
+with a Deis :ref:`Controller`. You must install the client to use Deis.
 
 Install with Pip
 ----------------
-Install the latest Deis client using Python's `pip`_:
+Install the latest Deis client using Python's pip_ package manager:
 
 .. code-block:: console
 
@@ -22,6 +22,14 @@ Install the latest Deis client using Python's `pip`_:
     $ deis
     Usage: deis <command> [<args>...]
 
+If you don't have Python_ installed, you can download a binary executable
+version of the Deis client for Mac OS X, Windows, or Debian Linux:
+
+    - https://s3-us-west-2.amazonaws.com/opdemand/deis-osx-0.8.0.tgz
+    - https://s3-us-west-2.amazonaws.com/opdemand/deis-win64-0.8.0.zip
+    - https://s3-us-west-2.amazonaws.com/opdemand/deis-deb-wheezy-0.8.0.tgz
+
+
 Integrated Help
 ---------------
 The Deis client comes with comprehensive documentation for every command.
@@ -60,4 +68,7 @@ To get help on subcommands, use ``deis help [subcommand]``:
 
     Use `deis help [command]` to learn more
 
-.. _`pip`: http://www.pip-installer.org/en/latest/installing.html
+.. _pip: http://www.pip-installer.org/en/latest/installing.html
+.. _Python: https://www.python.org/
+
+

docs/gettingstarted/usage.rst

@@ -1,15 +1,15 @@
 :title: Usage
-:description: Use the Deis Command-line interface to create a formation for your app, push your code, and scale your own cloud resources.
+:description: The command-line interface (CLI) is how you interact with Deis.
 
 .. _usage:
 
 Usage
 =====
-
-Once you have set up a Deis Controller (see the :ref:`Operations Guide <operations>`), you
-will use the Deis CLI (command-line interface) to create a formation for
-your app, push your code, and scale your own cloud resources.
+Once you have provisioned a Deis Controller
+(see the :ref:`Operations Guide <operations>`), use the
+command-line interface (CLI) to create a cluster for your app, to push
+your code, and to scale your cloud resources.
 
 .. automodule:: client.deis
-	:no-members:
-	:no-undoc-members:
+    :no-members:
+    :no-undoc-members:

docs/operations/register-admin-user.rst

@@ -5,12 +5,14 @@
 
 Register an Admin User
 ======================
-Once your :ref:`Controller` is running you need to register an admin user
-using the Deis command-line client.
+Once your :ref:`Controller` is running, you must register an admin user.
+using the Deis client. The Deis command-line interface (CLI), or client,
+allows you to interact with a Deis :ref:`Controller`. You must install
+the client to use Deis.
 
-Install the Deis Client
------------------------
-Install the latest Deis client using Python's `pip`_:
+Install with Pip
+----------------
+Install the latest Deis client using Python's pip_ package manager:
 
 .. code-block:: console
 
@@ -24,6 +26,13 @@ Install the latest Deis client using Python's `pip`_:
     $ deis
     Usage: deis <command> [<args>...]
 
+If you don't have Python_ installed, you can download a binary executable
+version of the Deis client for Mac OS X, Windows, or Debian Linux:
+
+    - https://s3-us-west-2.amazonaws.com/opdemand/deis-osx-0.8.0.tgz
+    - https://s3-us-west-2.amazonaws.com/opdemand/deis-win64-0.8.0.zip
+    - https://s3-us-west-2.amazonaws.com/opdemand/deis-deb-wheezy-0.8.0.tgz
+
 Register a User
 ---------------
 Now that the client is installed, create a user account on the Deis :ref:`Controller`.
@@ -51,5 +60,6 @@ Now that the client is installed, create a user account on the Deis :ref:`Contro
     :code:`deis register http://deis.example.com:8000`
 
 
-.. _`pip`: http://www.pip-installer.org/en/latest/installing.html
+.. _pip: http://www.pip-installer.org/en/latest/installing.html
+.. _Python: https://www.python.org/
 .. _`issue 535`: https://github.com/opdemand/deis/issues/535