(DOCSP-12801): Custom dashes for line charts (#428)

jeff-allen-mongo · cbush · Jeff Allen · jeff-allen-mongo · commit 7fb1ca9c33f2 · 2020-11-12T17:39:39.000-05:00
* (DOCSP-12801): Custom dashes for line charts Author: Jeff Allen <jeffrey.allen@10gen.com> * Apply suggestions from code review Co-authored-by: Chris Bush <chris.bush@10gen.com> * Additional refactoring for Customization Co-authored-by: Chris Bush <chris.bush@10gen.com> Co-authored-by: Jeff Allen <jeffrey.allen@mongodb.com>
diff --git a/source/chart-type-reference/column-bar-chart.txt b/source/chart-type-reference/column-bar-chart.txt
@@ -184,11 +184,6 @@ may be beneficial to use one over the other:
    - :ref:`Limit Data <charts-limit-data>`
    - :ref:`Bin data <charts-bin-data>`
 
-Limitations
------------
-
-The maximum query response size for column and bar charts is 5000 documents. 
-
 
 Examples
 --------
@@ -291,3 +286,19 @@ shade of green indicates a longer average runtime:
    :figwidth: 750px
    :alt: Colored Bar Chart Reference
 
+Customization Options
+---------------------
+
+The following customization options are specific to column and bar
+charts. To see all available customization options, see
+:ref:`customize-charts`.
+
+Show or Hide Data Value Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/customization/show-hide-data-labels.rst
+
+Limitations
+-----------
+
+The maximum query response size for column and bar charts is 5000 documents. 
diff --git a/source/chart-type-reference/donut-chart.txt b/source/chart-type-reference/donut-chart.txt
@@ -82,12 +82,6 @@ Consider using donut charts to display:
    :ref:`column or bar chart <column-bar-chart-ref>`.
 
 
-Limitations
------------
-
-The maximum query response size for a donut chart is 5000 documents. 
-
-
 Examples
 --------
 
@@ -163,3 +157,40 @@ segment according to the aggregated value signified in the
 :guilabel:`Arc` encoding channel. In this case, we aggregate the
 :guilabel:`mean` price for all properties rented by the day, week, and
 month.
+
+Customization Options
+---------------------
+
+The following customization options are specific to donut charts
+charts. To see all available customization options, see
+:ref:`customize-charts`.
+
+Show or Hide Data Value Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/customization/show-hide-data-labels.rst
+
+.. _show-hide-data-category-labels:
+
+Show or Hide Category Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can dictate whether |charts-short| displays text labels for
+**categories** in your donut charts.
+
+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 Category Labels` toggle switch to the desired
+   setting.
+
+.. note::
+
+   .. include:: /includes/fact-donut-chart-labels.rst
+
+Limitations
+-----------
+
+The maximum query response size for a donut chart is 5000 documents. 
diff --git a/source/chart-type-reference/line-area-chart.txt b/source/chart-type-reference/line-area-chart.txt
@@ -9,7 +9,7 @@ Line and Area Charts
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 1
    :class: singlecol
 
 Line charts and area charts display information as a series of data
@@ -98,13 +98,6 @@ showing relative percentages.
 For a detailed example, see the :ref:`100% Stacked Area Chart Example
 <one-hundred-stacked-area-example>`.
 
-
-Limitation
-----------
-
-The maximum document limit for discrete line and area charts is 5000 documents. 
-
-
 .. _continuous-charts:
 
 Continuous Line and Area Charts
@@ -159,12 +152,6 @@ Continuous line and area charts provide the following
           mapped to the :guilabel:`Y Axis aggregation`
           :ref:`encoding channel <encoding-channels>`.
 
-Limitation
-----------
-
-The maximum document limit for continuous line and area charts is 50000 documents. 
-
-
 Discrete Area Versus Continuous Area Charts Display
 ---------------------------------------------------
 
@@ -354,3 +341,59 @@ holds. This comparison shows how close the battery is to a full charge.
    along a range.  We want to plot each ``timestamp`` as an individual
    point, rather than show an aggregated value from many data values.
 
+Customization Options
+---------------------
+
+The following customization options are specific to line and area
+charts. To see all available customization options, see
+:ref:`customize-charts`.
+
+Show or Hide Data Markers
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On line and area charts, you can dictate whether |charts-short| displays
+visible data markers that represent individual data points. 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.
+
+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.
+
+Set Distinct Dash Style per Series on Line Charts
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On discrete and continuous line 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.
+
+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.
+
+Show or Hide Data Value Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/customization/show-hide-data-labels.rst
+
+Limitations
+-----------
+
+- The maximum document limit for discrete line and area charts is 5000
+  documents. 
+
+- The maximum document limit for continuous line and area charts is
+  50000 documents.
diff --git a/source/customize-charts.txt b/source/customize-charts.txt
@@ -17,6 +17,11 @@ of your visualizations. You can use these options to display your data
 in the proper format, show data labels to relay precise measurements,
 and many other formatting techniques.
 
+The documentation for specific chart types covers additional
+customization options pretaining to those charts. See the :ref:`Chart
+Types <chart-type-reference>` page to learn more about customizing a
+particular chart type.
+
 |charts| provides three types of customization options:
 
 General Customizaton Options
diff --git a/source/customize-charts/general-customization.txt b/source/customize-charts/general-customization.txt
@@ -20,58 +20,6 @@ visualization.
    :figwidth: 251px
    :alt: Field level customizations
 
-Show or Hide Data Markers on a Line Chart
------------------------------------------
-
-You can dictate whether |charts-short| displays visible data markers
-which represent individual data points on line charts. 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 view precise measurements.
-
-To set this option:
-
-1. Navigate to the :guilabel:`Customization` tab in the
-   :doc:`Chart Builder </build-charts>`.
-
-#. 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.
-
-Applicable Chart Types
-~~~~~~~~~~~~~~~~~~~~~~
-
-This customization option is available on the following chart types:
-:ref:`Discrete Line <discrete-charts>`,
-:ref:`Continuous Line <continuous-charts>`,
-:ref:`Discrete Area <discrete-charts>`, and
-:ref:`Continuous Area <continuous-charts>`.
-
-.. _show-hide-data-value-labels:
-
-Show or Hide Data Value Labels
-------------------------------
-
-You can dictate whether |charts-short| displays text labels for your
-data **values**. Data value labels show the exact values of your data
-points.
-
-To set this option:
-
-1. Navigate to the :guilabel:`Customization` tab in the
-   :doc:`Chart Builder </build-charts>`.
-
-#. In the :guilabel:`General Customization` section, set the
-   :guilabel:`Data Value Labels` toggle switch to the desired
-   setting.
-
-To customize the formatting of the number in the data label, modify
-the :ref:`Number Formatting <customize-number-formats>` settings for
-the relevant field.
-
 Applicable Chart Types
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -85,27 +33,6 @@ Line <discrete-charts>`, :ref:`Continuous Line <continuous-charts>`,
 :ref:`Continuous Area <continuous-charts>`, and
 :ref:`Donut <donut-chart-ref>`.
 
-.. note::
-
-   .. include:: /includes/fact-donut-chart-labels.rst
-
-.. _show-hide-data-category-labels:
-
-Show or Hide Data Category Labels on Donut Charts
--------------------------------------------------
-
-You can dictate whether |charts-short| displays text labels for
-data **categories** in your donut charts.
-
-To set this option:
-
-1. Navigate to the :guilabel:`Customization` tab in the
-   :doc:`Chart Builder </build-charts>`.
-
-#. In the :guilabel:`General Customization` section, set the
-   :guilabel:`Data Category Labels` toggle switch to the desired
-   setting.
-
 .. note::
 
    .. include:: /includes/fact-donut-chart-labels.rst
@@ -117,8 +44,8 @@ You can resize the text labels on a chart. Resizing text labels changes:
 
 - Axis labels
 - Axis tick labels
-- :ref:`Data value labels <show-hide-data-value-labels>`
-- :ref:`Data category labels <show-hide-data-category-labels>`
+- Data value labels
+- Data category labels
 - Legend caption and entries
 
 To set this option:
diff --git a/source/includes/customization/show-hide-data-labels.rst b/source/includes/customization/show-hide-data-labels.rst
@@ -0,0 +1,15 @@
+You can dictate whether |charts-short| displays text labels for your
+data **values**. Data value labels show the exact values of your data
+points.
+
+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 Value Labels` toggle switch to the desired
+   setting.
+
+To customize the formatting of the number in the data label, modify
+the :ref:`Number Formatting <customize-number-formats>` settings for
+the relevant field.
