(DOCSP-14016) Refactor customization docs (#452)

* Standardize headings

* Break geospatial customization options out to individual pages

* Fixes

* Addressing feedback

* wip

* wip

* resize menu screenshots

* Integrate new section after merge

Author: zach-carr

source/chart-type-reference/choropleth.txt

@@ -34,8 +34,8 @@ and your location field value must be one of the 50 states.
 
 .. _choropleth-enc-channels:
 
-Encoding Channels
------------------
+Choropleth Chart Encoding Channels
+----------------------------------
 
 Choropleth charts use the following :ref:`encoding channels
 <encoding-channels>`:
@@ -89,21 +89,46 @@ A choropleth chart is a good choice to compare:
    a high-level comparison, consider using a
    :ref:`Data Table <data-table-ref>`.
 
-Limitation
-----------
+Customization Options
+---------------------
 
-The maximum query response size for a choropleth chart is 5000 documents. 
+The following customization options are specific to choropleth
+charts. For general customization options, see :ref:`customize-charts`.
 
+.. include:: /includes/customization/auto-set-viewport.rst
 
-Example
--------
+Opacity
+~~~~~~~
+
+The :guilabel:`Opacity` level of a map modifies the degree to which
+the chart's map data shows through the data point markers.
+
+Choropleth charts default to ``100%``.
+
+Custom Color Palette
+~~~~~~~~~~~~~~~~~~~~
+
+The color palette specifies the range of colors that corresponds to
+relative aggregated values in your map. Choropleth charts use a 
+gradient color picker.
+
+To enable palette customization, toggle the 
+:guilabel:`Custom Color Palette` switch in the :guilabel:`General` 
+section.
+
+For more information, see :ref:`Color Palette Customization
+<color-palette-customization>`.
+
+Examples
+--------
 
 The following choropleth chart visualizes the total count of
 movie releases across various countries. Each document in the
 collection contains an array of countries where a particular movie was
 released.
 
 .. figure:: /images/charts/geo-type-choropleth.png
+   :alt: Choropleth example chart
 
 In this chart, we specify a
 :ref:`Shape Scheme <choropleth-shape-scheme>` of
@@ -131,6 +156,12 @@ high movie release counts compared with other countries.
    their expected values, refer to the
    :ref:`Choropleth Regions <choropleth-regions>` page.
 
+Limitations
+-----------
+
+The maximum query response size for a choropleth chart is 5000 
+documents.
+
 .. toctree::
    :titlesonly:
 

source/chart-type-reference/column-bar-chart.txt

@@ -184,6 +184,17 @@ may be beneficial to use one over the other:
    - :ref:`Limit Data <charts-limit-data>`
    - :ref:`Bin data <charts-bin-data>`
 
+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
 
 Examples
 --------
@@ -286,19 +297,8 @@ 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. 
+The maximum query response size for column and bar charts is 5000 
+documents.

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

@@ -95,19 +95,20 @@ You can use data tables to show:
   exercises categorized by the type of exercise and time of day the
   exercised was performed.
 
-
-Limitations
------------
-
-The maximum query response size for a data table is 50000 documents. 
-
 .. _data-table-example:
 
 Customization Options
 ---------------------
 
-You have the option to make text which does not fit in a single data cell
-wrap across multiple lines. This setting is off by default. To turn it on:
+The following customization options are specific to data table charts. 
+To see all available customization options, see
+:ref:`customize-charts`.
+
+Wrap Text
+~~~~~~~~~
+
+You can wrap text that does fit in a single data cell across multiple 
+lines.. This setting is off by default. To turn it on:
 
 1. Select the :guilabel:`Customize` tab of the Chart Builder.
 #. Expand the :guilabel:`Fields` section.
@@ -180,6 +181,11 @@ mean weekly price as currency.
    Blank table cells indicate that there are no documents that match
    the corresponding intersection of ``property_type`` and ``suburb``.
 
+Limitations
+-----------
+
+The maximum query response size for a data table is 50000 documents. 
+
 .. toctree::
    :titlesonly:
 

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

@@ -87,6 +87,50 @@ Consider using donut charts to display:
    values as a proportion to a whole, consider using a
    :ref:`column or bar chart <column-bar-chart-ref>`.
 
+Customization Options
+---------------------
+
+The following customization options are specific to donut
+charts. To see all available customization options, see
+:ref:`customize-charts`.
+
+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
+
+Show or Hide Data Value Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/customization/show-hide-data-labels.rst
+
+.. _show-hide-data-category-labels:
+
+Show Value or Percentage Labels
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can dictate whether a :ref:`Donut Chart <donut-chart-ref>` displays 
+data values as raw values or percentages. By default, data value labels 
+show the raw values of your data points. For percentage values in 
+:ref:`Donut Charts <donut-chart-ref>`, the whole value is the total 
+value of the entire chart. Percentage labels are always rounded to one 
+decimal place, and do not adhere to :ref:`Number Formatting 
+<customize-number-formats>` settings.
+
+.. include:: /includes/customization/show-value-or-percentage-labels.rst
 
 Examples
 --------
@@ -164,51 +208,6 @@ segment according to the aggregated value signified in 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 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
-
-Show or Hide Data Value Labels
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. include:: /includes/customization/show-hide-data-labels.rst
-
-.. _show-hide-data-category-labels:
-
-Show Value or Percentage Labels
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can dictate whether a :ref:`Donut Chart <donut-chart-ref>` displays 
-data values as raw values or percentages. By default, data value labels 
-show the raw values of your data points. For percentage values in 
-:ref:`Donut Charts <donut-chart-ref>`, the whole value is the total 
-value of the entire chart. Percentage labels are always rounded to one 
-decimal place, and do not adhere to :ref:`Number Formatting 
-<customize-number-formats>` settings.
-
-.. include:: /includes/customization/show-value-or-percentage-labels.rst
-
 Limitations
 -----------
 

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

@@ -49,14 +49,64 @@ Gauge charts provide the following :ref:`encoding channels
           choose either :guilabel:`Max` or :guilabel:`Min` from the
           :guilabel:`Aggregate` dropdown menu.  
 
+.. _target-max:
+
+Target and Maximum Interaction
+------------------------------
+
+The value encoded in the :guilabel:`Target` channel and the
+:guilabel:`Maximum` customization affect each others' behavior. The
+followling table explains the effect on the chart of having one, both,
+or neither of the values set.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 60
+
+   * - Target
+     - Maximum
+     - Behavior
+
+   * - None
+     - Default
+     - No target line. Gauge maximum is the next power of 10 above the value
+       of the Value channel.
+
+   * - None
+     - Custom
+     - No target line. Gauge maximum is the specified value.
+
+   * - Encoded
+     - Default
+     - Target line is rendered. Gauge maximum matches the target value. 
+
+   * - Encoded
+     - Custom
+     - Target line is rendered. Gauge maximum is the specified value.
+
+Use Cases
+---------
+
+Gauge charts are useful for displaying a data value represented as a fraction
+of a larger value. Gauge charts are a familiar way to represent a situation in 
+which a container may be either full or empty or somewhere in between.
+
+Consider using gauge charts to represent:
+
+- Occupancy rates in a hotel
+
+- Progress towards a fundraising goal
+
+- The water level in a reservoir
+
 Cutomization Options
 --------------------
 
 To access the customization options, click the :guilabel:`Customize` tab
 above the encoding channels in the Chart Builder.
 
 .. figure:: /images/charts/customize-tab.png
-   :figwidth: 200
+   :figwidth: 251px
    :alt: Customization tab
 
 General Customization
@@ -169,66 +219,16 @@ Target Field
        the chart.
      - None
 
-.. _target-max:
-
-Target and Maximum Interaction
-------------------------------
-
-The value encoded in the :guilabel:`Target` channel and the
-:guilabel:`Maximum` customization affect each others' behavior. The
-followling table explains the effect on the chart of having one, both,
-or neither of the values set.
-
-.. list-table::
-   :header-rows: 1
-   :widths: 20 20 60
-
-   * - Target
-     - Maximum
-     - Behavior
-
-   * - None
-     - Default
-     - No target line. Gauge maximum is the next power of 10 above the value
-       of the Value channel.
-
-   * - None
-     - Custom
-     - No target line. Gauge maximum is the specified value.
-
-   * - Encoded
-     - Default
-     - Target line is rendered. Gauge maximum matches the target value. 
-
-   * - Encoded
-     - Custom
-     - Target line is rendered. Gauge maximum is the specified value.
-
-Use Cases
----------
-
-Gauge charts are useful for displaying a data value represented as a fraction
-of a larger value. Gauge charts are a familiar way to represent a situation in 
-which a container may be either full or empty or somewhere in between.
-
-Consider using gauge charts to represent:
-
-- Occupancy rates in a hotel
-
-- Progress towards a fundraising goal
-
-- The water level in a reservoir
-
 .. _gauge-chart-example:
 
-Example
--------
+Examples
+--------
 
 The following chart shows progress towards a goal. A clothing retailer has
 a goal of selling 100 green shirts per month.
 
 .. figure:: /images/charts/gauge-chart-example.png
-   :figwidth: 600
+   :figwidth: 251px
    :alt: Gauge chart example
 
 This chart uses a filter to find sales order documents in which the ``item``