(DOCSP-10382) PATH note (#18)

* (DOCSP-10382) PATH note

Author: zach-carr

source/commands.txt

@@ -115,8 +115,8 @@ connected to your deployment.
        - Legacy :binary:`mongo <mongo>` shell
        - ``mongosh`` shell.
 
-       To learn how to install the legacy :binary:`mongo <mongo>`
-       shell, see :manual:`Instal MongoDB </installation>`.
+
+       .. include:: /includes/admonitions/warn-configure-path.rst
 
 Playground Commands
 -------------------

source/includes/admonitions/warn-configure-path.rst

@@ -0,0 +1,20 @@
+.. important::
+
+   To launch your selected MongoDB shell, you must:
+
+   - Install the shell you want to use, and
+
+   - Configure your machine's ``PATH`` environment variable to include 
+     the filepath to your shell binary.
+
+   If you install a new version of your MongoDB shell, you will need to 
+   update your ``PATH`` variable to reference the new version.
+
+.. seealso::
+
+   - To install the legacy :binary:`mongo <mongo>`
+     shell, see :manual:`The mongo Shell </mongo>`.
+
+   - To install the ``mongosh`` shell and for instructions on 
+     configuring your ``PATH`` variable, see 
+     `Install the MongoDB Shell <https://docs.mongodb.com/mongodb-shell/install>`__.

source/settings.txt

@@ -44,6 +44,8 @@ The following table lists the available settings for
 
        - ``mongosh`` (the new MongoDB shell)
 
+       .. include:: /includes/admonitions/warn-configure-path.rst
+
      - ``mongo``
 
    * - :guilabel:`Show`