(DOCSP-11133): Add callout to mongosh

Author: jeff-allen-mongo

conf.py

@@ -71,7 +71,8 @@ def has(self, *args):
     '.. |branch| replace:: ``{0}``'.format(conf.git.branches.current),
     '.. |bi| replace:: MongoDB Connector for BI',
     '.. |version| replace:: {0}'.format(version),
-    '.. |compass| replace:: MongoDB Compass'
+    '.. |compass| replace:: MongoDB Compass',
+    '.. |mdb-shell| replace:: MongoDB Shell'
 ])
 
 source_constants = {
@@ -101,6 +102,7 @@ def has(self, *args):
     'mms-home': ('https://www.mongodb.com/cloud/cloud-manager%s', ''),
     'opsmgr': ('https://docs.opsmanager.mongodb.com/current%s', ''),
     'atlas': ('https://docs.atlas.mongodb.com%s',''),
+    'mongosh': ('https://docs.mongodb.com/mongodb-shell%s', ''),
     'products': ('https://www.mongodb.com/products%s', ''),
     'wtdocs': ('https://source.wiredtiger.com/mongodb-3.4%s', ''),
     'perl-api': ('https://metacpan.org/pod/MongoDB::%s', ''),

source/core/shell-types.txt

@@ -10,6 +10,8 @@ Data Types in the ``mongo`` Shell
    :depth: 2
    :class: singlecol
 
+.. include:: /includes/fact-mongosh-callout.rst
+
 MongoDB :term:`BSON` provides support for additional data types than
 :term:`JSON`. :ecosystem:`Drivers </drivers>` provide native
 support for these data types in host languages and the

source/includes/fact-mongosh-callout.rst

@@ -0,0 +1,11 @@
+.. note::
+
+   The following document pertains to the :binary:`~bin.mongo` shell
+   included in the
+   `MongoDB Server Download
+   <https://www.mongodb.com/try/download/community?tck=docs_server>`__.
+   For information on the new MongoDB Shell, ``mongosh``, refer to the
+   :mongosh:`mongosh Documentation </>`.
+
+   To understand the differences between the two shells, see
+   :ref:`compare-mongosh-mongo`.

source/mongo.txt

@@ -14,6 +14,8 @@ The :binary:`~bin.mongo` shell is an interactive JavaScript interface to
 MongoDB. You can use the :binary:`~bin.mongo` shell to query and update
 data as well as perform administrative operations.
 
+.. include:: /includes/fact-mongosh-callout.rst
+
 Download the ``mongo`` Shell
 ----------------------------
 
@@ -395,10 +397,41 @@ Exit the Shell
 
 To exit the shell, type ``quit()`` or use the ``<Ctrl-C>`` shortcut.
 
+.. _compare-mongosh-mongo:
+
+Comparison of the ``mongo`` Shell and ``mongosh``
+-------------------------------------------------
+
+.. note::
+
+   :mongosh:`mongosh </>` is currently available as a
+   **Beta** release. The product, its features, and the corresponding
+   documentation may change during the Beta stage.
+
+The new MongoDB Shell, :mongosh:`mongosh </>`, offers numerous
+advantages over the :binary:`~bin.mongo` shell, such as:
+
+- Improved syntax highlighting.
+
+- Improved command history.
+
+- Improved logging.
+
+During the beta stage, ``mongosh`` supports a subset of the
+:binary:`~bin.mongo` shell methods. Achieving feature parity between
+``mongosh`` and the ``mongo`` shell is an ongoing effort.
+
+To maintain backwards compatibility, the methods that ``mongosh``
+supports use the same syntax as the corresponding methods in the
+:binary:`~bin.mongo` shell. To see the complete list of methods
+supported by ``mongosh``, see
+:mongosh:`MongoDB Shell Methods </reference/methods>`.
+
 .. seealso::
 
    - :gettingstarted:`Getting Started Guide </shell>`
    - :binary:`~bin.mongo` Reference Page
+   - :mongosh:`mongosh Documentation </>`
 
 .. class:: hidden
 

source/reference/mongo-shell.txt

@@ -10,6 +10,8 @@
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-mongosh-callout.rst
+
 ``mongo`` Shell Command History
 -------------------------------
 

source/tutorial/access-mongo-shell-help.txt

@@ -12,6 +12,8 @@ Access the ``mongo`` Shell Help
    :depth: 1
    :class: twocols
 
+.. include:: /includes/fact-mongosh-callout.rst
+
 In addition to the documentation in the :doc:`MongoDB Manual
 </index>`, the :binary:`~bin.mongo` shell provides some additional
 information in its "online" help system. This document provides an
@@ -174,4 +176,3 @@ shell, such as ``BinData()``, type ``help misc`` in the
    help misc
 
 .. seealso:: :doc:`/reference/method`
-

source/tutorial/configure-mongo-shell.txt

@@ -10,6 +10,8 @@ Configure the ``mongo`` Shell
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-mongosh-callout.rst
+
 .. _shell-use-a-custom-prompt:
 
 Customize the Prompt

source/tutorial/write-scripts-for-the-mongo-shell.txt

@@ -10,6 +10,8 @@ Write Scripts for the ``mongo`` Shell
    :depth: 1
    :class: singlecol
 
+.. include:: /includes/fact-mongosh-callout.rst
+
 You can write scripts for the :binary:`~bin.mongo` shell in JavaScript that
 manipulate data in MongoDB or perform administrative operation.