Navigation under "Reference" and "Manuals," Registry warning, "Latest" UCP/DTR (#5469)

* Revamp Product Manuals and Reference

* Nips and tucks

* Lose the snark

.gitignore

@@ -7,3 +7,4 @@ _site/**
 CNAME
 Gemfile.lock
 _samples/library/**
+_kbase/**

_config.yml

@@ -23,6 +23,8 @@ docker_ee_version: "17.06"
 compose_version: "1.17.0"
 machine_version: "0.13.0"
 distribution_version: "2.6"
+dtr_version: "2.4"
+ucp_version: "2.2"
 
 ucp_versions:
   - version: "2.2"

index.md

@@ -338,9 +338,9 @@ the industry to modernize all applications. Docker EE Advanced comes with enterp
         <div class="col-sm-12 col-md-12 col-lg-4 block">
             <div class="component">
                 <div class="component-icon">
-                    <a href="datacenter/ucp/2.2/guides/"> <img src="../images/UCP_48.svg" alt="Universal Control Plane"> </a>
+                    <a href="datacenter/ucp/{{ site.ucp_version }}/guides/"> <img src="../images/UCP_48.svg" alt="Universal Control Plane"> </a>
                 </div>
-                <h3 id="ucp"><a href="datacenter/ucp/2.2/guides/">Universal Control Plane</a></h3>
+                <h3 id="ucp"><a href="datacenter/ucp/{{ site.ucp_version }}/guides/">Universal Control Plane</a></h3>
                 <p>(UCP) Manage a cluster of on-premise Docker hosts like a single machine with this enterprise product.</p>
             </div>
         </div>
@@ -348,9 +348,9 @@ the industry to modernize all applications. Docker EE Advanced comes with enterp
         <div class="col-sm-12 col-md-12 col-lg-4 block">
             <div class="component">
                 <div class="component-icon">
-                    <a href="datacenter/dtr/2.3/guides/"> <img src="../images/dtr_48.svg" alt="Docker Trusted Registry"> </a>
+                    <a href="datacenter/dtr/{{ site.dtr_version }}/guides/"> <img src="../images/dtr_48.svg" alt="Docker Trusted Registry"> </a>
                 </div>
-                <h3 id="dtr"><a href="datacenter/dtr/2.3/guides/">Docker Trusted Registry</a></h3>
+                <h3 id="dtr"><a href="datacenter/dtr/{{ site.dtr_version }}/guides/">Docker Trusted Registry</a></h3>
                 <p>(DTR) An enterprise image storage solution you can install behind a firewall to manage images and access.</p>
             </div>
         </div>

reference.md

@@ -22,8 +22,8 @@ various APIs, CLIs, and file formats.
 | [Engine CLI](/engine/reference/commandline/cli/)          | The main CLI for Docker, includes all `docker` and [`dockerd`](/engine/reference/commandline/dockerd/) commands|
 | [Compose CLI](/compose/reference/overview/)           | The CLI for Docker Compose, which allows you to build and run multi-container applications                       |
 | [Machine CLI](/machine/reference/)                    | Manages virtual machines that are pre-configured to run Docker                                                   |
-| [UCP CLI](/datacenter/ucp/2.2/reference/cli/index.md) | Deploy and manage Universal Control Plane                                                                       |
+| [UCP CLI](/datacenter/ucp/{{ site.ucp_version }}/reference/cli/index.md) | Deploy and manage Universal Control Plane                                                                       |
-| [DTR CLI](/datacenter/dtr/2.4/reference/cli/index.md) | Deploy and manage Docker Trusted Registry                                                                                       |
+| [DTR CLI](/datacenter/dtr/{{ site.dtr_version }}/reference/cli/index.md) | Deploy and manage Docker Trusted Registry                                                                                       |
 
 ## Application programming interfaces (APIs)
 
@@ -44,3 +44,9 @@ various APIs, CLIs, and file formats.
 | [Machine drivers](/machine/drivers/os-base/)           | Enables support for given cloud providers when provisioning resources with Machine |
 | [Registry token authentication](/registry/spec/auth/)  | Outlines the Docker registry authentication scheme                                 |
 | [Registry storage drivers](/registry/storage-drivers/) | Enables support for given cloud providers when storing images with Registry        |
+
+## Compliance control reference
+
+| Reference | Description |
+| --------- | ----------- |
+| [NIST 800-53 control reference](/compliance/reference/800-53/) | All of the NIST 800-53 Rev. 4 controls applicable to Docker Enterprise Edition can be referenced in this section. |

registry/index.md

@@ -6,6 +6,16 @@ redirect_from:
 title: Docker Registry
 ---
 
+> Looking for Docker Trusted Registry?
+>
+> Docker Trusted Registry (DTR) is a commercial product that enables complete
+> image management workflow, featuring LDAP integration, image signing,
+> security scanning, and integration with Universal Control Plane. DTR is
+> offered as an add-on to Docker Enterprise subscriptions of Standard or
+> higher.
+>
+> [Go to Docker Trusted Registry](/datacenter/dtr/{{ site.dtr_version }}/guides/){: class="button outline-btn" }
+
 ## What it is
 
 The Registry is a stateless, highly scalable server side application that stores
@@ -34,7 +44,7 @@ into [Docker Trusted Registry](/datacenter/dtr/2.1/guides/index.md).
 
 The Registry is compatible with Docker engine **version 1.6.0 or higher**.
 
-## TL;DR
+## Basic commands
 
 Start your registry