1.24 release (#477)

* DOCSP-15704/15705 Atlas Data Lakes in the Add Data Source dialog (#472)

* DOCSP-15704 Atlas Data Lakes in the Add Data Source dialog

* DOCSP-15704 updates for copy review feedback

* DOCSP-15704 updates for external review feedback

* (DOCSP-15680): Created a new page for Combo Charts. (#473)

* (DOCSP-15680): Created a new page for Combo Charts.

* (DOCSP-15680): Incorporated Zach's feedback.

* (DOCSP-15680): Incorporated Tom's feedback.

* (DOCSP-15680): Incorporated Tom's feedback.

* (DOCSP-14861) Conditional Formatting (#474)

* (DOCSP-14861) Conditional formatting

* (DOCSP-15579) Add Dutch provinces choropleth scheme (#476)

* (DOCSP-15579) Add Dutch province shape scheme

* (DOCSP-16067) 1.24.2 release notes (#475)

* (DOCSP-16067) 1.24.2 release notes

Co-authored-by: kanchana-mongodb <[email protected]>
Co-authored-by: corryroot <[email protected]>

Author: 3 people

conf.py

@@ -62,6 +62,8 @@
     '.. |checkmark| unicode:: U+2713',
     '.. |tls-ssl| replace:: :abbr:`TLS (Transport Layer Security)`/:abbr:`SSL (Secure Sockets Layer)`',
     '.. |service| replace:: Atlas',
+    '.. |adl| replace:: Atlas Data Lake',
+    '.. |dl| replace:: Data Lake',
     '.. |enc-channel| replace:: :ref:`encoding channel <encoding-channels>`',
     '.. |aws| replace:: :abbr:`AWS (Amazon Web Services)`',
     '.. |gcp| replace:: :abbr:`GCP (Google Cloud Platform)`',

config/sphinx_local.yaml

@@ -28,6 +28,7 @@ theme:
      - /chart-type-reference/circular-charts
      - /encoding-channels
      - /customize-charts
+     - /customize-charts/conditional-formatting
      - /embedding-charts
      - /view-export-chart-data
      - /embedding-tutorials

snooty.toml

@@ -11,7 +11,9 @@ toc_landing_pages = ["/installation", "/dashboards", "/data-sources",
                      "/chart-types", "/chart-type-reference/data-table", 
                      "/chart-type-reference/geo-spatial", 
                      "/chart-type-reference/choropleth",
-                     "/customize-charts", "/embedding-charts", 
+                     "/customize-charts", 
+                     "/customize-charts/conditional-formatting",
+                     "/embedding-charts", 
                      "/view-export-chart-data", 
                      "/embedding-tutorials",
                      "/embedding-charts-sdk",
@@ -25,6 +27,8 @@ charts = "MongoDB Charts"
 charts-short = "Charts"
 tls-ssl = ":abbr:`TLS (Transport Layer Security)`/:abbr:`SSL (Secure Sockets Layer)`"
 service = "Atlas"
+adl = "Atlas Data Lake"
+dl = "Data Lake"
 enc-channel = ":ref:`encoding channel <encoding-channels>`"
 aws =  ":abbr:`AWS (Amazon Web Services)`"
 gcp =  ":abbr:`GCP (Google Cloud Platform)`"

source/chart-type-reference/choropleth-regions.txt

@@ -48,8 +48,8 @@ expected :guilabel:`Location` values:
 
    * - :guilabel:`Canadian Provinces`
      - Full names and :wikipedia:`two-letter codes <Canadian_postal_abbreviations_for_provinces_and_territories>`
-       for Canadian provinces expressed in English or French language.
-     - ``New Brunswick``, ``Nouveau-Brunswick``.
+       for Canadian provinces, expressed in English or French language.
+     - ``New Brunswick``, ``Nouveau-Brunswick``
 
    * - :guilabel:`UK Countries`
      - Countries in the United Kingdom.
@@ -75,23 +75,27 @@ expected :guilabel:`Location` values:
      - ``Norfolk``, ``Essex``
 
    * - :guilabel:`German States`
-     -
-       - Full names and
-       - :wikipedia:`two-letter German state codes <States_of_Germany#List>`
-         of German states expressed in German or English language.
+     - Full names and 
+       :wikipedia:`two-letter German state codes <States_of_Germany#List>`
+       of German states, expressed in German or English language.
      - ``Saxony``, ``Sachsen``
 
    * - :guilabel:`Australian States`
      - :wikipedia:`Full names and abbreviations <States_and_territories_of_Australia#States_and_territories>`
        for Australian states.
-     - ``Victoria``, ``VIC``.
+     - ``Victoria``, ``VIC``
 
    * - :guilabel:`Australian Local Government Areas`
      - Australian local government areas.
      - ``Yarra``, ``Waverley``
 
    * - :guilabel:`Italian Regions`
      - `Full names and three-letter abbreviations <https://www.circolocalabrese.org/geography/standard-abbreviations-of-italian-regions-and-provinces.asp>`__
-       for all Italian regions in expressed Italian or English language.
+       for all Italian regions, expressed in Italian or English 
+       language.
      - ``Liguria``, ``LIG``
 
+   * - :guilabel:`Dutch Provinces`
+     - `Full names and abbreviations <https://www.landafkorting.nl/provincies.htm>`__ for Dutch provinces, expressed in Dutch or 
+       English language.
+     - ``Drenthe``, ``DR``

source/chart-type-reference/combo-charts.txt

@@ -0,0 +1,186 @@
+.. _combo-chart-ref:
+
+============
+Combo Charts
+============
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Combo charts offer a combined :ref:`column <column-bar-chart-ref>` and 
+:ref:`line <line-area-chart-ref>` view.
+
+Combo Chart Encoding Channels
+-----------------------------
+
+Combo charts provide the following
+:ref:`encoding channels <encoding-channels>`:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 80
+
+   * - Encoding Channel
+     - Description
+
+   * - X Axis
+     - In the :guilabel:`category` axis encoding channel, a column is 
+       rendered for each unique value from this field.
+
+   * - Columns
+     - - The fields that you use in this channel build the columns in 
+         this chart.      
+
+       - The :guilabel:`aggregation` axis encoding channel dictates
+         which field to aggregate on and the type of aggregation to
+         perform. This ultimately dictates the size of each column.
+
+       .. note::
+
+          You can map multiple fields to this channel to create 
+          a multi-series chart. However, unlike other charts, you can't 
+          create a multi-series chart with the :guilabel:`Series` 
+          channel on combo charts. To learn more, see
+          :ref:`Multiple Field Mappings <multiple-field-mappings>`.
+
+   * - Lines
+     - - The fields that you use in this channel build one or more 
+         lines on this chart.      
+
+       - The :guilabel:`aggregation` axis encoding channel dictates
+         which field to aggregate on and the type of aggregation to
+         perform.
+
+Combo Chart Types
+-----------------
+
+Combo charts provide the following sub-types:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 80
+
+   * - Sub-Type Name
+     - Description
+
+   * - :ref:`Grouped <grouped-combo-ref-example>`
+     - |charts| groups data by the category specified in the
+       :guilabel:`category` :ref:`encoding channel
+       <encoding-channels>`, and plots a column for each value
+       in the :guilabel:`Columns` encoding channel.
+
+   * - :ref:`Stacked <stacked-combo-ref-example>`
+     - |charts| creates a column for each distinct value in the
+       :guilabel:`category` :ref:`encoding channel <encoding-channels>`
+       field, and splits each column into segments based on the
+       the :guilabel:`Columns` encoding channel.
+
+Use Cases
+---------
+
+- Combo charts bring together the useful aspects of both :ref:`column 
+  <column-bar-chart-ref>` and :ref:`line <line-area-chart-ref>` charts 
+  into a single chart.
+
+Customization Options
+---------------------
+
+The following customization options are specific to combo
+charts. To see all available customization options, see
+:ref:`customize-charts`.
+
+.. note::
+
+   If the columns and lines in your combo use different scales, 
+   consider a :ref:`secondary-y-axis`. This option appears on the 
+   :guilabel:`Customize` pane in the :guilabel:`Fields` section for any 
+   fields mapped to the :guilabel:`Lines` channel. Fields mapped to the 
+   :guilabel:`Columns` channel appear only on the primary axis.
+
+Adjust X-Axis Label Angle
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+You can adjust the X-axis label angle.
+
+.. include:: /includes/customization/adjust-x-axis-label-angle.rst
+
+Set Distinct Dash Style per Series
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On combo charts, you can opt to display each series in the chart with a 
+distinct dash style. This option can help make your chart more 
+accessible by distinguishing between series beyond color.
+
+.. include:: /includes/customization/set-distinct-dash-style-per-series.rst
+
+Smooth Lines
+~~~~~~~~~~~~
+
+.. include:: /includes/customization/smooth-lines.rst
+
+Show or Hide Data Markers
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On combo charts, you can dictate whether |charts-short| displays
+visible data markers that represent individual data points along the 
+line. Enabling this option makes it easier to see exactly where your 
+data points lie along a line. Hovering over these markers shows the 
+exact data values in a tooltip, making it easier to view precise 
+measurements.
+
+.. include:: /includes/customization/show-hide-data-markers.rst
+
+Show or Hide Data Value Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/customization/show-hide-data-labels.rst
+
+Examples
+--------
+
+.. _grouped-combo-ref-example:
+
+Grouped Combo Chart
+~~~~~~~~~~~~~~~~~~~
+
+The following grouped combo chart shows the number of award 
+nominations, wins, and metascores by director.
+
+The :guilabel:`X Axis` category of ``director`` creates a group
+for each director in the data set, and each group is split by the
+:guilabel:`Columns` encoding channel fields of ``nominations`` and 
+``wins``. The :guilabel:`Lines` encoding channel field of 
+``metacritic`` displays as a line:
+
+.. figure:: /images/charts/combo-chart-grouped.png
+   :figwidth: 750px
+   :alt: Grouped Combo Chart Reference
+
+.. _stacked-combo-ref-example:
+
+Stacked Combo Chart
+~~~~~~~~~~~~~~~~~~~~
+
+The following stacked combo chart shows the number of award 
+nominations, wins, and metascores by director.
+
+The :guilabel:`X Axis` category of ``director`` creates a column for 
+each director in the data set, :ref:`limited <charts-limit-data>` to 
+only the top 10 as sorted by the aggregated sum of ``awards.wins`` from 
+:guilabel:`Columns`. The :guilabel:`Columns` encoding channel fields of 
+``nominations`` and ``wins`` segment each column. The :guilabel:`Lines` 
+encoding channel field of ``metacritic`` displays as a line:
+
+.. figure:: /images/charts/combo-chart-stacked.png
+   :figwidth: 750px
+   :alt: Stacked Combo Chart Reference
+
+Limitations
+-----------
+
+The maximum query response size for combo charts is 5000 
+documents.

source/chart-type-reference/data-table.txt

@@ -138,6 +138,18 @@ the column you want to unpin. The :icon-fa5:`map-pin` button toggles off
 and if the column is a :guilabel:`Group` column, it moves to the right
 of any pinned :guilabel:`Group` columns.
 
+Conditional Formatting
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can create styling rules for table cell values that match 
+conditions you define. Conditional formatting rules affect the look of 
+your chart dynamically: if the value of a table cell changes to match 
+or stop matching your conditions, its styling updates to reflect that.
+
+To learn how to use conditional formatting rules, see the 
+:ref:`Conditional Formatting <conditional-formatting>` 
+customization option.
+
 Examples
 --------
 

source/chart-type-reference/line-area-chart.txt

@@ -239,16 +239,7 @@ this option makes it easier to see exactly where your data points lie
 along a line. Hovering over these markers shows the exact data values in
 a tooltip, making it easier to view precise measurements.
 
-To set this option:
-
-1. Open the :ref:`Customize <customize-charts>` pane for your chart.
-
-#. In the :guilabel:`General Customization` section, set the
-   :guilabel:`Data Markers` toggle switch to the desired setting.
-
-To customize the formatting of the number in the data marker tooltip,
-modify the :ref:`Number Formatting <customize-number-formats>`
-settings for the relevant field.
+.. include:: /includes/customization/show-hide-data-markers.rst
 
 Set Distinct Dash Style per Series on Line Charts
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -258,13 +249,7 @@ series in the chart with a distinct dash style. This option can help
 make your chart more accessible by distinguishing between
 series beyond color.
 
-To set this option:
-
-1. Open the :ref:`Customize <customize-charts>` pane for your chart.
-
-#. In the :guilabel:`General Customization` section, set the
-   :guilabel:`Dash Styles per Series` toggle switch to the desired
-   setting.
+.. include:: /includes/customization/set-distinct-dash-style-per-series.rst
 
 Show or Hide Data Value Labels
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -279,39 +264,7 @@ Add a Trendline
 Smooth Lines
 ~~~~~~~~~~~~
 
-You can change the way lines are drawn on your chart. To smooth lines:
-
-1. Open the :ref:`Customize <customize-charts>` pane for your chart.
-
-#. In the :guilabel:`General Customization` section, set
-   :guilabel:`Line Smoothing` to the desired option.
-
-The following line smoothing options are available:
-
-.. list-table::
-   :header-rows: 1
-   :stub-columns: 1
-   :widths: 30 70
-
-   * - Option
-     - Description
-
-   * - None (Default)
-     - Draws straight lines between data points.
-
-   * - Smooth
-     - Draws curved lines between data points.
-
-   * - Step Before
-     - Lines extend horizontally to data points. This is useful 
-       for visualizing data that only changes in intervals and is 
-       collected at the end of a period, such as 
-       daily average temperature.
-
-   * - Step After
-     - Lines extend horizontally from data points. This is useful 
-       for visualizing data that only changes in intervals, such as 
-       stock prices.
+.. include:: /includes/customization/smooth-lines.rst
 
 Examples
 --------

source/chart-type-reference/number-chart.txt

@@ -33,6 +33,21 @@ average number of vacant rooms across all hotels, or apply a
 :ref:`filter <charts-filter-documents>` to see the total number of
 vacant rooms in a select region.
 
+Customization Options
+---------------------
+
+Conditional Formatting
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can style the number that your chart displays with conditional 
+formatting rules. These rules are applied dynamically: if your 
+number changes to match or stop matching a condition you define, its 
+styling updates.
+
+To learn how to use conditional formatting rules, see the 
+:ref:`Conditional Formatting <conditional-formatting>` 
+customization option.
+
 .. _number-chart-example:
 
 Examples