DOCSP-29682 bitNot Aggregation Operator (#3148) (#3192)

* DOCSP-29682 bitNot Aggregation Operator

* add to toc and aggregation page

* build errors

* copy cleanup

* DC feedback

* additional feedback

Author: ajhuh-mdb

source/meta/aggregation-quick-reference.txt

@@ -356,6 +356,7 @@ Index of Expression Operators
    - :group:`$avg`
    - :expression:`$binarySize`
    - :expression:`$bitAnd`
+   - :expression:`$bitNot`
    - :expression:`$bitOr`
    - :expression:`$bsonSize`
    - :expression:`$ceil`

source/reference/operator/aggregation.txt

@@ -274,6 +274,13 @@ Alphabetical Listing of Expression Operators
 
        .. versionadded:: 6.3
 
+   * - :expression:`$bitNot`
+
+     - Returns the result of a bitwise ``not`` operation on a single argument 
+       or an array that contains a single ``int`` or ``long`` value. 
+
+       .. versionadded:: 6.3
+
    * - :expression:`$bitOr`
 
      - Returns the result of a bitwise ``or`` operation on an array of ``int`` 
@@ -1293,6 +1300,7 @@ Alphabetical Listing of Expression Operators
    /reference/operator/aggregation/avg
    /reference/operator/aggregation/binarySize
    /reference/operator/aggregation/bitAnd
+   /reference/operator/aggregation/bitNot
    /reference/operator/aggregation/bitOr
    /reference/operator/aggregation/bottom
    /reference/operator/aggregation/bottomN

source/reference/operator/aggregation/bitNot.txt

@@ -0,0 +1,88 @@
+=====================
+$bitNot (aggregation)
+=====================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+  :local:
+  :backlinks: none
+  :depth: 1
+  :class: singlecol
+
+Definition
+----------
+
+.. versionadded:: 6.3
+
+.. expression:: $bitNot
+
+    Returns the result of a bitwise ``not`` operation on a single ``int`` or 
+    ``long`` value. 
+
+Syntax 
+------
+
+The ``$bitNot`` operator has the following syntax: 
+
+.. code-block:: javascript
+
+      { $bitNot: <expression> }
+
+The expression can be a single argument or an array with one ``int`` or ``long`` 
+element.
+
+Behavior
+--------
+
+.. include:: /includes/fact-mongosh-integer-long-constructors.rst
+
+.. include:: /includes/fact-bitwise-type-error.rst
+
+If the expression evalutates to ``null``, the operation returns ``null``. 
+
+Example
+--------
+
+The example on this page uses the ``switches`` collection: 
+
+.. code-block:: javascript 
+
+    db.switches.insertMany( [
+        { _id: 0, a: NumberInt(0), b: NumberInt(127) },
+        { _id: 1, a: NumberInt(2), b: NumberInt(3) },
+        { _id: 2, a: NumberInt(3), b: NumberInt(5) }
+    ] )
+
+The following aggregation uses the ``$bitNot`` operator in the 
+:pipeline:`$project` stage:
+
+.. code-block:: javascript 
+
+    db.switches.aggregate( [
+      { 
+        $project: { 
+          result: { 
+            $bitNot: "$a"
+          }
+        }
+      }
+    ])
+
+The operation returns the following results:
+
+.. code-block:: javascript 
+  :copyable: false
+
+    [
+      { _id: 0, result: -1 },
+      { _id: 1, result: -3 },
+      { _id: 2, result: -4 }
+    ]
+
+Learn More 
+----------
+
+- :ref:`aggregation-pipeline-operators`
+
+- :ref:`update-bit`