macOS install instructions (#5)

* WIP

* (DOCSP-10357): install macos instructions

* Apply suggestions from code review

Co-authored-by: jwilliams-mongo <[email protected]>

* apply copy review edits

Co-authored-by: jwilliams-mongo <[email protected]>

Author: jeff-allen-mongo

source/connect.txt

@@ -1,3 +1,5 @@
+.. _mdb-shell-connect:
+
 =======================
 Connect to a Deployment
 =======================

source/includes/steps-install-shell-macos.yaml

@@ -0,0 +1,55 @@
+---
+source:
+  file: steps-install-shell-base.yaml
+  ref: navigate-dlc
+ref: navigate-dlc-macos
+---
+source:
+  file: steps-install-shell-base.yaml
+  ref: open-mdb-shell-page
+ref: open-mdb-shell-page-macos
+---
+title: "Download the installation archive."
+ref: download-archive
+level: 4
+content: |
+---
+title: "Extract the files from the downloaded archive."
+ref: extract-archive
+level: 4
+content: |
+   
+   .. code-block::
+
+      tar -zxvf path/to/archive
+
+   Skip this step if your web browser automatically unzips the file as
+   part of the download.
+---
+title: "Add the MongoDB Shell binary to your ``PATH`` environment
+   variable."
+ref: add-shell-to-path
+level: 4
+content: |
+
+   You can either:
+
+   - Copy the |mdb-shell| binary into a directory listed in your ``PATH``
+     variable, such as ``/usr/local/bin`` (Update
+     ``/path/to/mongosh`` with your installation directory as
+     appropriate)
+
+     .. code-block:: sh
+
+       sudo cp /path/to/mongosh /usr/local/bin/
+
+   - Create a symbolic link to the |mdb-shell| binary from a directory listed in
+     your ``PATH`` variable, such as ``/usr/local/bin`` (Update
+     ``/path/to/mongosh`` with your installation directory as
+     appropriate):
+
+     .. code-block:: sh
+
+       sudo ln -s  /path/to/mongosh /usr/local/bin/
+
+...

source/index.txt

@@ -24,6 +24,21 @@ download center.
 Download and Install the |mdb-shell|
 ------------------------------------
 
+Prerequisites
+~~~~~~~~~~~~~
+
+To use the |mdb-shell|, you must have a MongoDB deployment to connect
+to. 
+
+- For a free cloud-hosted deployment, you can use
+  `MongoDB Atlas <https://www.mongodb.com/cloud/atlas?tck=docs_vsce>`__.
+
+- To learn how to run a local MongoDB deployment, see
+  :manual:`Install MongoDB </installation/>`.
+
+Procedure
+~~~~~~~~~
+
 .. tabs-platforms::
 
    .. tab::
@@ -34,13 +49,20 @@ Download and Install the |mdb-shell|
    .. tab::
       :tabid: macOS
 
-      Hello, I am macOS content.
+      .. include:: /includes/steps/install-shell-macos.rst
 
    .. tab::
       :tabid: linux
 
       Hello, I am Linux (rpm / deb) content.
 
+Connect to a MongoDB Deployment
+-------------------------------
+
+Once you have installed the |mdb-shell| and added it to you system
+``PATH``, you can connect to a MongoDB deployment. To learn more, see
+:ref:`mdb-shell-connect`.
+
 Multi-Line Operations in the |mdb-shell|
 ----------------------------------------