ref(domains): create domains and routing section

Author: slack

mkdocs.yml

@@ -39,6 +39,7 @@ pages:
     - Managing App Processes: applications/managing-app-processes.md
     - Managing App Configuration: applications/managing-app-configuration.md
     - Managing App Lifecycle: applications/managing-app-lifecycle.md
+    - Domains and Routing: applications/domains-and-routing.md
     - SSL Certificates: applications/ssl-certificates.md
   - Managing Workflow:
     - Configuring Load Balancers: managing-workflow/configuring-load-balancers.md

src/applications/domains-and-routing.md

@@ -0,0 +1,22 @@
+## Domains and Routing
+
+You can use `deis domains` to add or remove custom domains to your 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
+appname to the old one:
+
+    $ dig hello.deisapp.com
+    [...]
+    ;; ANSWER SECTION:
+    hello.bacongobbler.com.         1759    IN    CNAME    finest-woodshed.deisapp.com.
+    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
+    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).

src/applications/managing-app-configuration.md

@@ -51,29 +51,6 @@ the application to an external PostgreSQL database.
 
 Detachments can be performed with `deis config:unset`.
 
-## Custom Domains
-
-You can use `deis domains` to add or remove custom domains to your 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
-appname to the old one:
-
-    $ dig hello.deisapp.com
-    [...]
-    ;; ANSWER SECTION:
-    hello.bacongobbler.com.         1759    IN    CNAME    finest-woodshed.deisapp.com.
-    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
-    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).
-
 
 ## Custom Health Checks