Updated per S&T review.

Author: Anthony Sansone

Makefile

@@ -27,15 +27,15 @@ publish: migrate-assets ## Builds this branch's publishable HTML and other artif
 
 stage: ## Host online for review
 	mut-publish build/${GIT_BRANCH}/html ${STAGING_BUCKET} --prefix=${PROJECT} --stage ${ARGS}
-	@echo "Hosted at ${STAGING_URL}/${PROJECT}/${USER}/${GIT_BRANCH}/index.html"
+	@echo "\n\nHosted at ${STAGING_URL}/${PROJECT}/${USER}/${GIT_BRANCH}/index.html"
 
 fake-deploy: build/public/${GIT_BRANCH} ## Do a fake deploy on the staging bucket
 	mut-publish build/public/${GIT_BRANCH} ${STAGING_BUCKET} --prefix=${PROJECT} --deploy ${ARGS}
-	@echo "Hosted at ${STAGING_URL}/${PROJECT}/index.html"
+	@echo "\n\nHosted at ${STAGING_URL}/${PROJECT}/index.html"
 
 deploy: ## Deploy to the production bucket
 	mut-publish build/public ${PRODUCTION_BUCKET} --prefix=${PROJECT} --deploy --redirects build/public/.htaccess ${ARGS}
-	@echo "Hosted at ${PRODUCTION_URL}/${PROJECT}/${GIT_BRANCH}/index.html"
+	@echo "\n\nHosted at ${PRODUCTION_URL}/${PROJECT}/${GIT_BRANCH}/index.html"
 
 	$(MAKE) deploy-search-index
 

source/download.txt

@@ -0,0 +1,24 @@
+.. raw:: html
+
+   <style type="text/css">
+     table.docutils {
+       width: 100%
+     }
+     code.descname, code.docutils.literal > .pre, code.xref.mongodb.mongodb-alert.docutils.literal {
+       font-size: 90%
+     }
+     div.ui-setting dl.setting dt code.descname {
+       font-size: 100%;
+       font-family: Akzidenz,"Helvetica Neue",Helvetica,Arial,sans-serif;
+       font-weight: 700;
+     }
+     dl.setting > dt > code.descname {
+       font-size: 100%;
+     }
+     caption > .caption-text {
+       text-align: left
+     }
+     ul.guide__pills.pillstrip-declaration {
+       margin-left: 0em;
+     }
+   </style>

source/includes/styles/corrections.rst

@@ -148,7 +148,6 @@ suit your needs.
    .. toctree::
       :titlesonly:
 
-      /download
       /install
       /connect
       /instance

source/index.txt

@@ -1,14 +1,110 @@
-===============
-Install Compass
-===============
+============================
+Download and Install Compass
+============================
 
 .. default-domain:: mongodb
 
-.. tabs::
+.. include:: /includes/styles/corrections.rst
+
+.. tabs-pillstrip:: platforms
+
+Software Requirements
+---------------------
+
+|compass-short| requires:
+
+.. tabs-platforms::
+
+   tabs:
+     - id: macos
+       content: |
+
+         - 64-bit version of macOS 10.10 or later.
+         - MongoDB 3.0 or later.
+
+     - id: windows
+       content: |
+
+         - 64-bit version of Microsoft Windows 7 or later.
+         - MongoDB 3.0 or later.
+         - `Microsoft .NET Framework version 4.5 or later <https://www.microsoft.com/en-us/download/details.aspx?id=30653>`__.
+           
+           The |compass-short| installer prompts you to install the
+           minimum required version of the .NET framework if it is not
+           already installed on your system.
+
+     - id: debian
+       content: |
+
+         - 64-bit version of Ubuntu 14.04 or later.
+         - MongoDB 3.0 or later.
+
+     - id: rhel
+       content: |
+
+         - 64-bit version of RHEL 7+ or later.
+         - MongoDB 3.0 or later.
+
+.. _macOS Terminal: https://support.apple.com/guide/terminal/welcome/mac
+.. _Windows Powershell: https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-6
+.. _zsh: https://www.zsh.org/
+.. _bash: https://www.gnu.org/software/bash/
+.. _ksh: http://www.kornshell.com/
+
+Download Compass
+----------------
+
+To download |compass-short|, you can use your preferred web browser.
+
+.. tabs-platforms::
+
+   tabs:
+     - id: macos
+       content: |
+
+         1. Open the {+download-page+}.
+
+         #. Download the latest version of |compass| for
+            macOS. The |compass| installer is a ``.dmg`` disk
+            image.
+
+     - id: windows
+       content: |
+
+         1. Open the {+download-page+}.
+
+         #. Select the installer you prefer. The |compass| installer is
+            available as a ``.exe`` or ``.msi`` package or a ``.zip``
+            archive.
+
+         #. Download the latest version of |compass| for
+            Windows. 
+
+     - id: debian
+       content: |
+
+         1. Open the {+download-page+}.
+
+         #. Download the latest version of |compass| for
+            Ubuntu. The |compass| installer is a ``.deb``
+            package.
+
+     - id: rhel
+       content: |
+
+         1. Open the {+download-page+}.
+
+         #. Download the latest version of |compass| for Red Hat
+            Enterprise Linux. The |compass| installer is a ``.rpm``
+            package.
+
+Install Compass
+---------------
+
+.. tabs-platforms::
 
    tabs:
-     - id: osx
-       name: macOS
+     - id: macos
        content: |
 
          1. Once you have downloaded |compass-short|, double-click on
@@ -43,22 +139,21 @@ Install Compass
             system password before launching |compass-short|.
 
      - id: windows
-       name: Windows
        content: |
 
          1. Double-click the installer file to install |compass-short|.
             By default, the installer extracts |compass-short| to the
             following path:
 
             .. code-block:: ini
+               :copyable: false
 
                C:\Users\<user>\AppData\Local\<MongoDB Compass Edition>\
 
          #. Once installed, |compass-short| launches and prompts you to
             configure privacy settings and specify update preferences.
 
-     - id: ubuntu
-       name: Ubuntu
+     - id: debian
        content: |
 
          1. Double-click on the ``.deb`` package icon to start
@@ -79,7 +174,6 @@ Install Compass
                mongodb-compass
 
      - id: rhel
-       name: RHEL
        content: |
 
          #. Install Compass: