docs(applications): add deis routing docs

Author: Matthew Fisher

src/applications/domains-and-routing.md

@@ -1,11 +1,11 @@
 ## Domains and Routing
 
-You can use `deis domains` to add or remove custom domains to your application:
+You can use `deis domains` to add or remove custom domains to the application:
 
     $ deis domains:add hello.bacongobbler.com
     Adding hello.bacongobbler.com to finest-woodshed... done
 
-Once that's done, you can go into your DNS registrar and set up a CNAME from the new
+Once that's done, you can go into a DNS registrar and set up a CNAME from the new
 appname to the old one:
 
     $ dig hello.deisapp.com
@@ -15,8 +15,23 @@ appname to the old one:
     finest-woodshed.deisapp.com.    270     IN    A        172.17.8.100
 
 !!! note
-    Setting a CNAME for your root domain can cause issues. Setting your @ record
+    Setting a CNAME for a root domain can cause issues. Setting an @ record
     to be a CNAME causes all traffic to go to the other domain, including mail and the SOA
     ("start-of-authority") records. It is highly recommended that you bind a subdomain to
     an application, however you can work around this by pointing the @ record to the
     address of the load balancer (if any).
+
+To add or remove the application from the routing mesh, use `deis routing`:
+
+    $ deis routing:disable
+    Disabling routing for finest-woodshed... done
+
+This will make the application unreachable through the [Router][], but the application is still
+reachable internally through its [Kubernetes Service][service]. To re-enable routing:
+
+    $ deis routing:enable
+    Enabling routing for finest-woodshed... done
+
+
+[router]: ../understanding-workflow/components.md#router
+[service]: ../reference-guide/terms.md#service

src/reference-guide/terms.md

@@ -55,10 +55,12 @@ The Controller stack includes:
 
 - Django API Server for handling API calls
 
+
 ## Key
 
 Deis keys are SSH Keys used during the git push process. Each user can use the client to manage a list of keys on the Controller.
 
+
 ## Release
 
 A Deis release is a combination of a Build with a Config. Each Application is associated with one release at a time. Deis releases are numbered and new releases always increment by one (e.g. v1, v2, v3).
@@ -73,3 +75,8 @@ The Scheduler is responsible for creating, starting, stopping, and destroying Co
 The Scheduler must decide which machines are eligible to run these container jobs. Scheduler backends vary in the details of their job allocation policies and whether or not they are resource-aware, among other features.
 
 The Deis scheduler client is implemented in the Controller component.
+
+
+## Service
+
+A Kubernetes Service is an abstraction which defines a logical set of Pods and a policy by which to access them. In Workflow, a Service is used to load-balance an application's [Containers](#containers) internally through a virtual IP address.