ref(client,registration,deploy): move stuff to more logical spot

Author: slack

src/applications/deploying-apps.md

@@ -2,7 +2,6 @@
 
 An [Application][] is deployed to Deis using `git push` or the `deis` client.
 
-
 ## Supported Applications
 
 Deis can deploy any application or service that can run inside a Docker container.  In order to be scaled horizontally, applications must follow the [Twelve-Factor App][] methodology and store any application state in external backing services.
@@ -25,6 +24,20 @@ using the URL supplied by their Deis administrator.
     password:
     Logged in as deis
 
+## Upload Your SSH Public Key
+
+If you plan on using `git push` to deploy applications to Deis, you must provide your SSH public key.  Use the `deis keys:add` command to upload your default SSH public key, usually one of:
+
+* ~/.ssh/id_rsa.pub
+* ~/.ssh/id_dsa.pub
+
+```
+    $ deis keys:add
+    Found the following SSH public keys:
+    1) id_rsa.pub
+    Which would you like to use with Deis? 1
+    Uploading /Users/myuser/.ssh/id_rsa.pub to Deis... done
+```
 
 ## Select a Build Process
 

src/using-workflow/installing-the-client.md

@@ -16,18 +16,6 @@ somewhere in your $PATH:
     $ ln -fs $PWD/deis /usr/local/bin/deis
 
 
-## Proxy Support
-
-If your workstation uses a proxy to reach the network where the cluster lies,
-set the `http_proxy` or `https_proxy` environment variable to enable proxy support:
-
-    $ export http_proxy="http://proxyip:port"
-    $ export https_proxy="http://proxyip:port"
-
-!!! note
-    Configuring a proxy is generally not necessary for local Vagrant clusters.
-
-
 ## Integrated Help
 
 The Deis client comes with comprehensive documentation for every command.
@@ -65,7 +53,6 @@ To get help on subcommands, use `deis help [subcommand]`:
 
 ## Multiple Profile Support
 
-
 The Deis client supports running commands against multiple installations
 and/or accounts by setting the `$DEIS_PROFILE` environment variable
 before logging in and running any subsequent commands. If not set, all
@@ -76,5 +63,15 @@ of running the ps command against an app with the same name from two profiles:
     $ DEIS_PROFILE=production deis ps -a helloworld
     $ DEIS_PROFILE=staging deis ps -a helloworld
 
+## Proxy Support
+
+If your workstation uses a proxy to reach the network where the cluster lies,
+set the `http_proxy` or `https_proxy` environment variable to enable proxy support:
+
+    $ export http_proxy="http://proxyip:port"
+    $ export https_proxy="http://proxyip:port"
+
+!!! note
+    Configuring a proxy is generally not necessary for local Vagrant clusters.
 
 [controller]: ../understanding-workflow/components.md#controller

src/using-workflow/registering-a-user.md

@@ -6,8 +6,7 @@ To use Deis, you must first register a user on the [Controller][].
 ## Register with a Controller
 
 Use `deis register` with the [Controller][] URL (supplied by your Deis administrator)
-to create a new account.  When you have completed the registration process, you will be logged in
-automatically.
+to create a new account. After successful registration you will be logged in as the new user.
 
     $ deis register http://deis.example.com
     username: myuser
@@ -18,47 +17,35 @@ automatically.
     Logged in as myuser
 
 !!! important
-    The first user to register with Deis receives "superuser" privileges. Additional users who
-    register will be ordinary users. It's also possible to disable user registration after creating
-    the superuser account.
+    The first user to register with Deis Workflow is automatically becomes a
+    "superuser". Additional users who register will be ordinary users. It's also
+    possible to disable user registration after creating the superuser account.
 
+## Login to Workflow
 
-## Upload Your SSH Public Key
-
-If you plan on using `git push` to deploy applications to Deis, you must provide your SSH public key.  Use the `deis keys:add` command to upload your default SSH public key, usually one of:
-
-* ~/.ssh/id_rsa.pub
-* ~/.ssh/id_dsa.pub
-
-```
-$ deis keys:add
-Found the following SSH public keys:
-1) id_rsa.pub
-Which would you like to use with Deis? 1
-Uploading /Users/myuser/.ssh/id_rsa.pub to Deis... done
-```
+If you already have an account, use `deis login` to authenticate against the Deis Workflow API.
 
+    $ deis login http://deis.example.com
+    username: deis
+    password:
+    Logged in as deis
 
-## Logout from a Controller
+## Logout from Workflow
 
 Logout of an existing controller session using `deis logout`.
 
     $ deis logout
     Logged out as deis
 
+## Verify your session
 
-## Login to a Controller
+You can verify your client configuration by running `deis whoami`.
 
-If you already have an account, use `deis login` to authenticate against the Deis [Controller][].
-
-    $ deis login http://deis.example.com
-    username: deis
-    password:
-    Logged in as deis
+    $ deis whoami
+    You are deis at http://deis.example.com
 
 !!! note
-    Deis session information is stored in your user's ~/.deis directory.
-
+    Session and client configuration is stored in the `~/.deis/client.json` file.
 
 [controller]: ../understanding-workflow/components.md#controller
 [router]: ../understanding-workflow/components.md#router