DOCSP-26223-track-variables (#24)

* DOCSP-26223-track-variables

* JS PR fixes + collection name correction in images

Author: rustagir

source/analyze-code.txt

@@ -99,8 +99,8 @@ To analyze your builder expressions in Visual Studio, perform the following acti
 
 1. Install the {+product+} as described in the :ref:`Install <mongodb-analyzer-install>`
    guide.
-2. Write a builder expression with the {+driver-short+}
-3. Move your mouse over the :guilabel:`...` annotation beneath the first
+#. Write a builder expression with the {+driver-short+}
+#. Move your mouse over the :guilabel:`...` annotation beneath the first
    method of your builder expression to display an information message that contains
    the {+query-api+} translation.
 
@@ -121,6 +121,28 @@ information message displayed:
       .. figure:: /includes/images/builder-popup-photoshop.png
          :alt: Screenshot of builder expression in visual studio with information message displayed.
 
+The {+product+} supports builder variable tracking and composition. You can
+combine multiple builder expressions with `logical operators
+<https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/operators/boolean-logical-operators>`__
+and view the {+query-api+} translation in the information message.
+
+Click the following tabs to see a composed builder variable with and without an
+information message displayed:
+
+.. tabs::
+
+   .. tab:: Without Information Message
+      :tabid: no-message-variable
+
+      .. figure:: /includes/images/builder-variable.png
+         :alt: Screenshot of builder expression variable in visual studio with ellipsis annotation.
+
+   .. tab:: With Information Message
+      :tabid: message-variable
+
+      .. figure:: /includes/images/builder-variable-popup.png
+         :alt: Screenshot of builder expression variable in visual studio with information message displayed.
+
 .. include:: /includes/error-list-window.rst
 
 .. We use this anchor in a DocHub link
@@ -153,7 +175,6 @@ and its corresponding {+query-api+} translation:
              OrderBy(m => m.Score).
              ToListAsync();
 
-
    .. tab:: {+query-api+}
       :tabid: query-api-linq
 
@@ -175,8 +196,8 @@ To analyze your LINQ expressions in Visual Studio, perform the following actions
 
 1. Install the {+product+} as described in the :ref:`Install <mongodb-analyzer-install>`
    guide.
-2. Write a LINQ expression with the {+driver-short+}.
-3. Move your mouse over the :guilabel:`...` annotation beneath the first
+#. Write a LINQ expression with the {+driver-short+}.
+#. Move your mouse over the :guilabel:`...` annotation beneath the first
    method of your LINQ expression to display an information message that contains
    the {+query-api+} translation.
 

source/configuration.txt

@@ -95,6 +95,21 @@ by the {+product+}:
        | **Default**: ``"V2"``
        | **Accepted Values**: ``"V2"`` or ``"V3"``
 
+   * - | **EnableVariableTracking**
+     - | **Type:** boolean
+       |
+       | **Description:**
+       | Specifies if the {+product+} tracks and composes builder expression variables.
+       
+       .. tip::
+
+          To learn more about builder expressions, see the
+          :ref:`Analyze Your Code <mongodb-analyzer-analyze-builders>`
+          page.
+
+       | **Default**: ``true``
+       | **Accepted Values**: ``true`` or ``false``
+
    * - | **OutputDriverVersion**
      - | **Type:** boolean
        |