anchor.diff:  A route is made up of a _subdomain_ (or host) and a _domain_ that you can
   specify when you push an application.
   
  -In the route `myapp.<%=vars.app_domain%>`, the subdomain is `myapp` and the
  -domain is `<%=vars.app_domain%>`.
  -
  -## <a id='domains'></a>Key Facts About Domains ##
  -
  -In Cloud Foundry, domains are associated with orgs.
  +## <a id='domains'></a>Domains and Routes in Cloud Foundry ##
  +
  +A **domain** is a domain name like `acme.com` or `<%=vars.app_domain%>`. Domains can also be multi-level
  +and contain sub-domains like the “store” in `store.acme.com`. In Cloud Foundry, domains are associated with orgs. Domain objects are not directly bound to apps.
  +
  +Cloud Foundry also supports custom domains. You can map a registered domain of your own to a space in Cloud Foundry.
  +
  +A **route**, based on a domain with an optional host as a prefix, may be associated with
  +one or more applications. For example, `myapp` is the host and `<%=vars.app_domain%>` is the domain in the route `myapp.<%=vars.app_domain%>`. It is also possible to have a route that represents `<%=vars.app_domain%>` without a host. This type of route is
  +known as a zone apex domain or a root domain. Routes are children of domains and are
  +directly bound to apps in Cloud Foundry.
   
   A Cloud Foundry instance defines a default shared domain.
   Unless you specify a domain, `cf` uses the default shared domain in the route to
   your application.
   
  -Cloud Foundry also supports custom domains.
  -You can map a registered domain of your own to a space in Cloud Foundry, as
  -described below.
  -
   ## <a id='create-domains'></a>Use Your Custom Domain in Cloud Foundry ##
   
  -If you want to use a registered domain of your own, you must:
  -
  - 1. [Define the domain](#define-route) in Cloud Foundry and associate it with an organization.
  -
  -    The command below defines the custom domain `myapp.example.org` in the
  +There are three different models for using your own custom domain in Cloud Foundry. Select the procedure that corresponds with the type of domain you want to use.
  +
  +### <a id='root'></a>Map a Root Domain ###
  +
  +Use a DNS ALIAS record to map a custom root domain to your app.
  +
  + 1. Create the domain in Cloud Foundry and associate it with an organization.
  +
  +    The command below defines the custom domain `example.org` in the
   	"test-org" organization:
   
   	<pre class="terminal">
  -	$ cf create-domain test-org myapp.example.org
  -	</pre>
  -
  - 1. [Map the route to your app](#map-route).
  - 1. Set up your domain name DNS using one of the methods described below.
  -
  -**Custom subdomain**: Use a DNS CNAME record to alias one or more custom subdomains.
  -
  -To alias the custom domain, create a CNAME record to point `myapp.example.org` to `yourappname.cfapps.io`, as in the following example:
  +	$ cf create-domain test-org example.org
  +	</pre>
  +
  + 1. Map the route to your app:
  +
  +    <pre class="terminal">
  +	$ cf map-route myapp example.org
  +	</pre>
  +
  + 1. Configure your custom root domain with your DNS provider using an ALIAS record.
  +
  +ALIAS records follow the pattern illustrated below:
   
   <table border="1" class="nice" >
   	<tr>
  
positive.code: 		<th>Note</th>
  	</tr>
  	<tr>
  	  <td>CNAME</td>
  	  <td>myapp</td>
  	  <td>yourappname.cfapps.io.</td>
  	  <td>Refer to your DNS provider documentation to determine whether the trailing `.` is required.</td>
  	</tr>
  	</table>
  
  **Root domain**: Some DNS providers support using an alternative custom record type, such as ANAME or ALIAS, for configuring custom zone apex domains. These domains are also known as root domains. ANAME and ALIAS records follow the pattern below:
  
  <table border="1" class="nice" >
  	<tr>
  
negative.code: 		<th>Note</th>
  	</tr>
  	<tr>
  	  <td>CNAME</td>
  	  <td>test</td>
  	  <td>yourappname.cfapps.io.</td>
  	  <td>Refer to your DNS provider documentation to determine whether the trailing `.` is required.</td>
  	</tr>
  	</table>
  
  ### <a id='multi-sub'></a>Map Multiple Subdomains ###
  
  Use a DNS CNAME record to alias a custom subdomain.
  
   1. Create the domain in Cloud Foundry and associate it with an organization.
  
      The command below defines the custom domain `myapp.example.org` in the
  	"test-org" organization:
  
  	<pre class="terminal">
  	$ cf create-domain test-org example.org -n myapp
  	</pre>
  
   1. Map the route to your app:
  
      <pre class="terminal">
      $ cf map-route myapp example.org -n myapp
  	</pre>
  
   1. Configure your custom domain with your DNS provider using a CNAME record.
  
  	CNAME records follow the pattern illustrated below:
  
  	<table border="1" class="nice" >
  		<tr>
  			<th>Record</th>
  			<th>Name</th>
  			<th>Target</th>
  			<th>Note</th>
  		</tr>
  		<tr>
  		  <td>CNAME</td>
  		  <td>test</td>
  		  <td>yourappname.cfapps.io.</td>
  		  <td>Refer to your DNS provider documentation to determine whether the trailing `.` is required.</td>
  		</tr>
  		</table>
  
  ## <a id='view-domains'></a>View Domains for an Org ##
  
  