DOCSP-21627 Consistent Syntax Examples G-K (#1454)

* DOCSP-21627 Consistent Syntax Examples G-K

* updates comment-related include

* internal review feedback

* internal review feedback

Author: jmd-mongo

source/includes/extracts-dbcommands.yaml

@@ -1,8 +1,10 @@
 ref: comment-content
 content: |
-  Optional. A user-provided comment to attach to this command.
-  Once set, this comment appears alongside records of this command
-  in the following locations:
+  Optional. 
+
+  A user-provided comment to attach to this command. Once set, this 
+  comment appears alongside records of this command in the following 
+  locations:
   
   - :ref:`mongod log messages <log-messages-ref>`, in the
     ``attr.command.cursor.comment`` field.

source/reference/command/getAuditConfig.txt

@@ -21,13 +21,18 @@ Definition
    retrieves audit configurations from :binary:`~bin.mongod` and
    :binary:`~bin.mongos` server instances.
 
-   Use the
-   :method:`db.adminCommand( { command } )<db.adminCommand()>` method
-   to run :dbcommand:`getAuditConfig` against the ``admin`` database.
+Syntax
+------
 
-   .. code-block:: javascript
+The command has the following syntax:
+
+.. code-block:: javascript
 
-      db.adminCommand( { getAuditConfig: 1 } )
+   db.adminCommand( 
+      { 
+        getAuditConfig: 1 
+      } 
+   )
 
 Behavior
 --------

source/reference/command/getClusterParameter.txt

@@ -10,6 +10,9 @@ getClusterParameter
    :depth: 1
    :class: singlecol
 
+Definition
+----------
+
 .. dbcommand:: getClusterParameter
 
    :dbcommand:`getClusterParameter` is an administrative command for
@@ -19,40 +22,43 @@ getClusterParameter
    To run ``getClusterParameter``, use the ``db.adminCommand( { command } )`` 
    method.
 
-   Syntax
-   ------
+Syntax
+------
 
-   The ``getClusterParameter`` command has the following syntax:
-
-   .. code-block:: javascript
-
-      { getClusterParameter: <parameter> | [<parameter>, <parameter>] | "'*'" }
-      
-   The command takes the following fields:
+The command has the following syntax:
 
-   .. list-table::
-      :header-rows: 1
-      :widths: 20 20 80
-   
-      * - Field
-   
-        - Type
-   
-        - Description
-     
-      * - ``<parameter>``
-   
-        - String or array of strings 
+.. code-block:: javascript
 
-        - You can specify one of the following: 
-        
-          - The name of the parameter you want to retrieve.
-
-          - An array with the names of multiple parameters. 
-
-          - ``'*'``, to return values for all parameters available to
-            ``getClusterParameter``.
-
+   db.adminCommand( 
+      { 
+        getClusterParameter: <parameter> | [<parameter>, <parameter>] | "'*'" 
+      }
+   )
+    
+Command Fields
+--------------
+
+The command takes the following fields:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 80
+
+   * - Field
+     - Type
+     - Description
+ 
+   * - ``<parameter>``
+     - String or array of strings 
+     - You can specify one of the following: 
+
+       - The name of the parameter you want to retrieve.
+
+       - An array with the names of multiple parameters. 
+
+       - ``'*'``, to return values for all parameters available to
+         ``getClusterParameter``.
+ 
 Behavior
 --------
 

source/reference/command/getCmdLineOpts.txt

@@ -10,53 +10,68 @@ getCmdLineOpts
    :depth: 1
    :class: singlecol
 
+Definition
+----------
+
 .. dbcommand:: getCmdLineOpts
 
    The :dbcommand:`getCmdLineOpts` command returns a document
    containing command line options used to start the given
    :binary:`~bin.mongod` or :binary:`~bin.mongos`. Run
    :dbcommand:`getCmdLineOpts` in the ``admin`` database.
 
-   .. code-block:: javascript
-
-      db.adminCommand( { getCmdLineOpts: 1  } )
-
-   This command returns a document with two fields, ``argv`` and
-   ``parsed``. The ``argv`` field contains an array with each item from
-   the command string used to invoke :binary:`~bin.mongod` or
-   :binary:`~bin.mongos`. The document in the ``parsed`` field includes all
-   runtime options, including those parsed from the command line and
-   those specified in the configuration file, if specified.
-
-   Consider the following example output of
-   :dbcommand:`getCmdLineOpts`:
-
-   .. code-block:: javascript
-
-      {
-         "argv" : [
-            "/usr/bin/mongod",
-            "--config",
-            "/etc/mongod.conf"
-         ],
-         "parsed" : {
-            "config" : "/etc/mongod.conf",
-            "net" : {
-               "bindIp" : "127.0.0.1",
-               "port" : 27017
-            },
-            "processManagement" : {
-               "fork" : true
-            },
-            "storage" : {
-               "dbPath" : "/data/db"
-            },
-            "systemLog" : {
-               "destination" : "file",
-               "logAppend" : true,
-               "path" : "/var/log/mongodb/mongod.log"
-            }
-         },
-         "ok" : 1
-      }
+Syntax
+------
+
+The command has the following syntax:
+
+.. code-block:: javascript
+
+   db.adminCommand( 
+      { 
+        getCmdLineOpts: 1  
+      } 
+   )
+
+Output
+------
 
+This command returns a document with two fields, ``argv`` and
+``parsed``. The ``argv`` field contains an array with each item from
+the command string used to invoke :binary:`~bin.mongod` or
+:binary:`~bin.mongos`. The document in the ``parsed`` field includes all
+runtime options, including those parsed from the command line and
+those specified in the configuration file, if specified.
+
+Consider the following example output of
+:dbcommand:`getCmdLineOpts`:
+
+.. code-block:: javascript
+ 
+   {
+      "argv" : [
+         "/usr/bin/mongod",
+         "--config",
+         "/etc/mongod.conf"
+      ],
+      "parsed" : {
+         "config" : "/etc/mongod.conf",
+         "net" : {
+            "bindIp" : "127.0.0.1",
+            "port" : 27017
+         },
+         "processManagement" : {
+            "fork" : true
+         },
+         "storage" : {
+            "dbPath" : "/data/db"
+         },
+         "systemLog" : {
+            "destination" : "file",
+            "logAppend" : true,
+            "path" : "/var/log/mongodb/mongod.log"
+         }
+      },
+      "ok" : 1
+   }
+