(DOCSP-10747), (DOCSP-10474): bin data updates (#364)

* (DOCSP-10747), (DOCSP-10474): bin data updates

* (DOCSP-10747), (DOCSP-10474): add week formatting to field level options

* (DOCSP-10747), (DOCSP-10474): copy review fixes

* (DOCSP-10747), (DOCSP-10474): make examples consistent

* (DOCSP-10747), (DOCSP-10474): fix typo

Author: jwilliams-mongo

source/bin-data.txt

@@ -45,6 +45,7 @@ following bins for dates:
 
    * Year
    * Month
+   * Week of Year
    * Date of the Month
    * Day of the Week
    * Hour
@@ -155,3 +156,50 @@ to the visualization, rather than being grouped into bins.
    .. figure:: /images/charts/charts-numeric-binning.png
       :figwidth: 680px
       :alt: Charts numeric binning example
+
+Empty Bins
+----------
+
+When binning is enabled, |charts-short| displays entries for
+empty bins within the minimum and maximum data range a chart displays.
+
+.. admonition: Exception
+   :class: note
+
+   |charts-short| doesn't display empty bins if including them results
+   in more than 5000 unique bins on a chart.
+
+The value |charts-short| uses for empty bins depends on the
+aggregation function you choose:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 2 1
+
+   * - Aggregation Function
+     - Inferred Value
+
+   * - ``count`` or ``distinct``
+     - ``0``
+
+   * - All Other Functions
+     - ``null``
+
+|charts-short| displays bins with ``null`` values differently based on
+chart type:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 1 2
+
+   * - Chart Type
+     - How |charts-short| Displays ``null`` Bins
+
+   * - :ref:`column-bar-chart-ref`
+     - Bars with a height of ``0``. |charts-short| doesn't display data
+       labels for ``null`` bins, even if enabled.
+
+   * - :ref:`line-area-chart-ref`
+     - Linear interpolation, with no data marker on the ``null`` bins.
+       |charts-short| doesn't display data labels for ``null`` bins,
+       even if enabled.

source/customize-charts/field-level-options.txt

@@ -147,6 +147,13 @@ datetime format. The following table shows how to create custom datetime formats
    * - M
      - Month as numbers with no leading zero.
      - ``8``
+   * - [W]WW
+     - Week of the year preceded by a ``W`` and with a leading zero,
+       if applicable. 
+     - ``W01``
+   * - W
+     - Week of the year as numbers with no leading zero.
+     - ``1``
    * - DDDD
      - Day of the year, with leading zeroes if applicable.
      - ``076``