DOCSP-3674: mongo shell does not enable networkMessageCompressors by default

Author: kay-kim

source/includes/fact-networkMessageCompressors.rst

@@ -4,12 +4,6 @@
    compression. Otherwise, messages between the parties are
    uncompressed.
 
-You can specify the following compressors:
-
-- :term:`snappy` (Default)
-
-- :term:`zlib`
-
 If you specify multiple compressors, then the order in which you list
 the compressors matter as well as the communication initiator. For
 example, if a :binary:`~bin.mongo` shell specifies the following network

source/includes/options-conf.yaml

@@ -814,29 +814,14 @@ inherit:
 ---
 program: conf
 name: net.compression.compressors
-type: <string>
 directive: setting
-description: |
-
-   .. versionadded:: 3.4
-
-   .. versionchanged:: 3.6
-
-      - Add support for :term:`zlib` compressor.
-
-      - Enabled by default. To disable, set to ``disabled``.
-
-   Enables network compression for communication between this
-   :binary:`~bin.mongod` or :binary:`~bin.mongos` instance and:
-
-   - other members in the deployment, if a member of a replica set or a
-     sharded cluster
-
-   - a :binary:`~bin.mongo` shell
-
-   - drivers that support the ``OP_COMPRESSED`` message format.
+inherit:
+  name: networkMessageCompressors
+  program: mongod
+  file: options-mongod.yaml
+replacement:
+  program: ":binary:`~bin.mongod` or :binary:`~bin.mongos`"
 
-   .. include:: /includes/fact-networkMessageCompressors.rst
 ---
 program: conf
 name: net.serviceExecutor

source/includes/options-mongo.yaml

@@ -441,18 +441,19 @@ description: |
 
    .. versionadded:: 3.4
 
-   .. versionchanged:: 3.6
-
-      - Add support for :term:`zlib` compressor.
-      - Enabled by default. To disable, set to ``disabled``.
-
    Enables network compression for communication between this
    {{program}} shell and:
 
    - a :binary:`~bin.mongod` instance
 
    - a :binary:`~bin.mongos` instance.
 
+   You can specify the following compressors:	
+
+   - :term:`snappy`
+
+   - :term:`zlib` (Available in MongoDB 3.6 or greater)
+
    .. include:: /includes/fact-networkMessageCompressors.rst
 
 ---

source/includes/options-mongod.yaml

@@ -2917,33 +2917,38 @@ optional: true
 program: mongod
 name: networkMessageCompressors
 args: <string>
+default: snappy,zlib
 directive: option
 description: |
 
    .. versionadded:: 3.4
 
-   .. versionchanged:: 3.6
+   Specifies the default compressor(s) to use for
+   communication between this {{program}} instance and:
 
-      - Add support for :term:`zlib` compressor.
-      - Enabled by default. To disable, set to ``disabled``.
+   - {{deployment}}
 
-   Enables network compression for communication between this
-   {{program}} instance and:
+   - a :binary:`~bin.mongo` shell
 
-   - other members of the replica set, if the instance is part of a
-     replica set
+   - drivers that support the ``OP_COMPRESSED`` message format.
 
-   - other members of the sharded cluster, if the instance is part of a
-     sharded cluster
+   MongoDB supports the following compressors:
 
-   - a :binary:`~bin.mongo` shell,
+   - :term:`snappy`
 
-   - drivers that support the ``OP_COMPRESSED`` message format.
+   - :term:`zlib` (Available in MongoDB 3.6 or greater)
 
-   .. include:: /includes/fact-networkMessageCompressors.rst
+   **In versions 3.6 and 4.0**, :binary:`~bin.mongod` and
+   :binary:`~bin.mongos` enable network compression by default with
+   ``snappy`` as the compressor.
+   
+   To disable network compression, set the value to ``disabled``.
 
+   .. include:: /includes/fact-networkMessageCompressors.rst
 
 optional: true
+replacement: 
+   deployment: other members of the deployment if the instance is part of a replica set or a sharded cluster
 ---
 program: mongod
 name: serviceExecutor

source/includes/options-mongos.yaml

@@ -497,24 +497,14 @@ program: mongos
 name: networkMessageCompressors
 args: <string>
 directive: option
-description: |
-
-   .. versionadded:: 3.4
-
-   .. versionchanged:: 3.6
-
-      Add support for :term:`zlib` compressor.
-
-   Enables network compression for communication between this
-   {{program}} instance and:
-
-   - other members of the sharded cluster
-
-   - a :binary:`~bin.mongo` shell.
-
-   .. include:: /includes/fact-networkMessageCompressors.rst
-
+inherit:
+  name: networkMessageCompressors
+  program: mongod
+  file: options-mongod.yaml
 optional: true
+replacement: 
+   deployment: other members of the sharded cluster
+
 ---
 program: mongos
 name: serviceExecutor

source/release-notes/3.6.txt

@@ -816,18 +816,19 @@ Wire Protocol and Compression
   This opcode's message format is extensible and designed to subsume
   the functionality of other opcodes.
 
-- Added support for the ``zlib`` compressor for
+- MongoDB 3.6 adds support for the ``zlib`` compressor for
   ``--networkMessageCompressors`` option (or
   :setting:`net.compression.compressors` setting if using the
   configuration file). ``--networkMessageCompressors`` option (or
   :setting:`net.compression.compressors` setting) enables network
   compression for communication among :binary:`~bin.mongod`,
-  :binary:`~bin.mongos`, :binary:`~bin.mongo` shell, and drivers that support
-  the ``OP_COMPRESSED`` message format.
+  :binary:`~bin.mongos`, :binary:`~bin.mongo` shell, and drivers that
+  support the ``OP_COMPRESSED`` message format.
 
-- Enables ``snappy`` network compression for communication, by default,
-  among :binary:`~bin.mongod`, :binary:`~bin.mongos`, and :binary:`~bin.mongo`
-  shell.
+- :binary:`~bin.mongod` and :binary:`~bin.mongos` enable network
+  compression by default with ``snappy`` as the compressor. For more
+  information on network compression, see
+  :setting:`net.compression.compressors`.
 
 Read Concern
 ~~~~~~~~~~~~