javascript admonition

source/core/server-side-javascript.txt

@@ -16,8 +16,8 @@ Server-side JavaScript
 Overview
 --------
 
-MongoDB supports server-side execution of JavaScript code within the
-database process:
+MongoDB supports the execution of JavaScript code for the following
+server-side operations:
 
 - :dbcommand:`mapReduce` and the corresponding :program:`mongo` shell
   method :method:`db.collection.mapReduce()`. See
@@ -30,6 +30,9 @@ database process:
 
 - :ref:`running-js-scripts-in-mongo-on-mongod-host`
 
+.. |javascript-using-operation| replace:: the above operations use
+.. include:: /includes/admonition-javascript-prevalence.rst
+
 .. seealso::
 
    :doc:`/tutorial/store-javascript-function-on-server`

source/includes/admonition-javascript-prevalence.rst

@@ -1,6 +1,6 @@
-.. admonition:: JavaScript in MongoDB
+.. admonition::
 
-   Although |javascript-using-operation| uses JavaScript, most
-   interactions with MongoDB use an :doc:`idiomatic drivers
-   </applications/drivers>` to interact with MongoDB using the same
-   language as the application itself.
+   Although |javascript-using-operation| JavaScript, most interactions
+   with MongoDB do not use JavaScript but use an :doc:`idiomatic driver
+   </applications/drivers>` in the language of the interacting
+   application.

source/reference/command/eval.txt

@@ -39,7 +39,10 @@ eval
       .. include:: /includes/parameters-eval.rst
          :start-after: eval-param-nolock
 
-   Consider the following example which uses :dbcommand:`eval` to
+   .. |javascript-using-operation| replace:: :dbcommand:`eval` uses
+   .. include:: /includes/admonition-javascript-prevalence.rst
+
+   The following example uses :dbcommand:`eval` to
    perform an increment and calculate the average on the server:
 
       .. include:: /includes/examples-eval.rst
@@ -60,8 +63,8 @@ eval
    JavaScript interpreter evaluates functions entered directly into the
    shell.
 
-   If an error occurs, :dbcommand:`eval` throws an exception. Consider
-   the following invalid function that uses the variable ``x`` without
+   If an error occurs, :dbcommand:`eval` throws an exception.
+   The following invalid function uses the variable ``x`` without
    declaring it as an argument:
 
    .. code-block:: javascript

source/reference/command/group.txt

@@ -101,7 +101,10 @@ group
    the ``reduce`` field whereas the :dbcommand:`group` command takes
    the ``$keyf`` field and the ``$reduce`` field.
 
-   Consider the following examples of the :method:`db.collection.group()` method:
+   .. |javascript-using-operation| replace:: :dbcommand:`group` uses
+   .. include:: /includes/admonition-javascript-prevalence.rst
+
+   The following are examples of the :method:`db.collection.group()` method:
 
    The examples assume an ``orders`` collection with documents of the
    following prototype:

source/reference/command/mapReduce.txt

@@ -55,6 +55,9 @@ mapReduce
                      }
                    )
 
+   .. |javascript-using-operation| replace:: :dbcommand:`mapReduce` uses
+   .. include:: /includes/admonition-javascript-prevalence.rst
+
 .. note::
 
    .. versionchanged:: 2.4

source/reference/method.txt

@@ -1,15 +1,18 @@
 .. _js-administrative-methods:
 
-=======================
-``mongo`` Shell Methods
-=======================
+=============
+Shell Methods
+=============
 
 .. default-domain:: mongodb
 
 .. contents::
    :backlinks: none
    :local:
 
+.. |javascript-using-operation| replace:: these methods use
+.. include:: /includes/admonition-javascript-prevalence.rst
+
 Collection
 ----------