DOCSP-21630 Consistent Syntax Examples: S-W (#1491)

* DOCSP-21630 Consistent Syntax Examples: S-W

* internal review feedback

* addressing additional internal review feedback

Author: jmd-mongo

source/reference/command/serverStatus.txt

@@ -32,7 +32,11 @@ The command has the following syntax:
 
 .. code-block:: javascript
 
-   db.runCommand( { serverStatus: 1 } )
+   db.runCommand( 
+      { 
+        serverStatus: 1 
+      } 
+   )
 
 The value (i.e. ``1`` above) does not affect the operation of the
 command. The ``db.serverStatus()`` command returns a large amount of

source/reference/command/setAllowMigrations.txt

@@ -21,55 +21,59 @@ Definition
    from committing, and excludes the collection from new balancer 
    rounds.
 
-   The command has the following syntax:
+Syntax
+------
 
-   .. code-block:: javascript
+The command has the following syntax:
 
-      db.adminCommand( {
-        setAllowMigrations: "<db>.<collection>", 
-        allowMigrations: <true|false>
-      } )
-
-   The command takes the following parameters:
-
-   .. list-table::
-      :header-rows: 1
-      :widths: 20 20 60
-
-      * - Field
-        - Type
-        - Description
-
-      * - :ref:`setAllowMigrations <setAllowMigrations-cmd-coll>`
-
-        - ``string``
-        
-        - .. _setAllowMigrations-cmd-coll:
-          
-          The collection to modify.
-
-      * - :ref:`allowMigrations <setAllowMigrations-cmd-flag>`
-
-        - ``boolean``
-
-        - .. _setAllowMigrations-cmd-flag:
-        
-          If ``false``:
-
-          - MongoDB prevents new :ref:`automatic migrations 
-            <sharding-chunk-migration-automatic>` on the collection
-          - in-flight :ref:`manual migrations 
-            <sharding-chunk-migration-manual>` will not be committed
-          - the collection will be excluded from new balancer rounds
-
-          If ``true``: 
-          
-          - MongoDB allows new :ref:`automatic migrations 
-            <sharding-chunk-migration-automatic>` on the collection
-          - in-flight :ref:`manual migrations 
-            <sharding-chunk-migration-manual>` will be committed
-          - the collection will be included in new balancer rounds
+.. code-block:: javascript
 
+   db.adminCommand( 
+      {
+       setAllowMigrations: "<db>.<collection>", 
+       allowMigrations: <true|false>
+      } 
+   )
+
+Command Fields
+--------------
+
+The command takes the following parameters:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 60
+ 
+   * - Field
+     - Type
+     - Description
+ 
+   * - :ref:`setAllowMigrations <setAllowMigrations-cmd-coll>`
+     - ``string``
+     - .. _setAllowMigrations-cmd-coll:
+       
+       The collection to modify.
+ 
+   * - :ref:`allowMigrations <setAllowMigrations-cmd-flag>`
+     - ``boolean``
+     - .. _setAllowMigrations-cmd-flag:
+     
+       If ``false``:
+ 
+       - MongoDB prevents new :ref:`automatic migrations 
+         <sharding-chunk-migration-automatic>` on the collection
+       - in-flight :ref:`manual migrations 
+         <sharding-chunk-migration-manual>` will not be committed
+       - the collection will be excluded from new balancer rounds
+ 
+       If ``true``: 
+       
+       - MongoDB allows new :ref:`automatic migrations 
+         <sharding-chunk-migration-automatic>` on the collection
+       - in-flight :ref:`manual migrations 
+         <sharding-chunk-migration-manual>` will be committed
+       - the collection will be included in new balancer rounds
+ 
 Behavior
 --------
 

source/reference/command/setAuditConfig.txt

@@ -20,38 +20,51 @@ Definition
    :dbcommand:`setAuditConfig` is an administrative command that
    sets new audit configurations for :binary:`~bin.mongod` and
    :binary:`~bin.mongos` server instances at runtime.
+   
+   Use the :method:`db.adminCommand( { command } )<db.adminCommand()>` 
+   method to run :dbcommand:`setAuditConfig` against the ``admin`` 
+   database.
 
-   The command syntax is:
+Syntax
+------
 
-   .. code-block:: javascript
+The command has the following syntax:
 
-      { setAuditConfig: 1, filter: <Filter Document>, auditAuthorizationSuccess: <Boolean> }
-
-   :dbcommand:`setAuditConfig` has the following fields:
-
-   .. list-table::
-      :header-rows: 1
-      :widths: 20 20 80
-
-      * - Field
-        - Type
-        - Description
-
-      * - ``setAuditConfig``
-        - integer
-        - Run :dbcommand:`setAuditConfig`
-
-      * - ``filter``
-        - document
-        - An :doc:`audit filter </tutorial/configure-audit-filters>`
+.. code-block:: javascript
 
-      * - ``auditAuthorizationSuccess``
-        - boolean
-        - Log all, or only failed access authorizations
+   db.adminCommand(
+      { 
+        setAuditConfig: 1, 
+        filter: <Filter Document>,
+        auditAuthorizationSuccess: <Boolean> 
+      }
+   )
 
-   Use the
-   :method:`db.adminCommand( { command } )<db.adminCommand()>` method
-   to run :dbcommand:`setAuditConfig` against the ``admin`` database.
+Command Fields
+--------------
+
+The command has the following fields:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 80
+ 
+   * - Field
+     - Type
+     - Description
+ 
+   * - ``setAuditConfig``
+     - integer
+     - Run :dbcommand:`setAuditConfig`
+ 
+   * - ``filter``
+     - document
+     - An :doc:`audit filter </tutorial/configure-audit-filters>`
+ 
+   * - ``auditAuthorizationSuccess``
+     - boolean
+     - Log all, or only failed access authorizations
+ 
 
 Behavior
 --------

source/reference/command/setClusterParameter.txt

@@ -29,10 +29,14 @@ Syntax
 
 .. code-block:: javascript
 
-   db.adminCommand( { setClusterParameter: { <parameter>: <value> } } )
+   db.adminCommand( 
+      { 
+        setClusterParameter: { <parameter>: <value> } 
+      } 
+   )
 
 For the available cluster parameters, including examples, see
-:ref:`<cluster-parameters>`. 
+:ref:`cluster-parameters`. 
 
 Behavior
 --------