(DOCSP-11436): Show gauge chart as a percentage

Author: jeff-allen-mongo

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

@@ -56,74 +56,118 @@ 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: 252
+   :figwidth: 200
    :alt: Customization tab
 
 General Customization
 ~~~~~~~~~~~~~~~~~~~~~
 
-- :guilabel:`Custom Color Palette`
-  
-  Off by default. Toggle on to enable. Only the first palette color is used by
-  gauge charts.
-
-- :guilabel:`Value Label`
-
-  Off by default. Toggle on to enable. Controls whether a label is displayed
-  above the :guilabel:`Value` number.
-
-- :guilabel:`Max/Min Values`
-
-  On by default. Controls whether the minimum and maximum range
-  numbers are displayed at the left and right edges of the chart. 
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 60 20
 
-- :guilabel:`Target Label & Value`
+   * - Option
+     - Description
+     - Default
 
-  Off by default. Toggle on to enable. Controls whether the :guilabel:`Target`
-  value and its label are displayed at the bottom of the chart.
+   * - :guilabel:`Custom Color Palette`
+     - Only the first palette color is used by gauge charts.
+     - Off
+   
+   * - :guilabel:`Value Label`
+     - Controls whether a label is displayed above the
+       :guilabel:`Value` number.
+     - Off
+
+   * - :guilabel:`Max/Min Values`
+     - Controls whether the minimum and maximum range
+       numbers are displayed at the left and right edges of the chart.
+     - On
+
+   * - :guilabel:`Target Label & Value`
+     - Controls whether the :guilabel:`Target`
+       value and its label are displayed at the bottom of the chart.
+     - Off
+
+   * - :guilabel:`Show As Percentage`
+     - Controls whether the value of your gauge chart is
+       shown as a percentage of the :guilabel:`Target` value. If you
+       enable this option and do not have a :guilabel:`Target` value,
+       the value is shown is a percentage of the maximum value.
+       For more information, see :ref:`target-max`.
+     - Off
 
 Value Axis
 ~~~~~~~~~~
 
-- :guilabel:`Maximum`
-
-  Off by default. Toggle on to enable. Specifies the maximum range of the
-  gauge when enabled. See :ref:`Target and Maximum Interaction <target-max>`
-  for more information on how the maximum range of the gauge is determined.
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 60 20
 
-- :guilabel:`Minimum`
+   * - Option
+     - Description
+     - Default
 
-  Off by default. Toggle on to enable. Specifies the minimum range of the
-  gauge when enabled. Defaults to ``0``.
+   * - :guilabel:`Maximum`
+     - Specifies the maximum range
+       of the gauge when enabled. See :ref:`Target and Maximum
+       Interaction <target-max>` for more information on how the maximum
+       range of the gauge is determined.
+     - Off
+
+   * - :guilabel:`Minimum`
+     - Specifies the minimum range of the gauge when enabled. Defaults
+       to ``0``.
+     - Off
+  
 
 Value Field
 ~~~~~~~~~~~
 
-- :guilabel:`Label Override`
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 60 20
 
-  Off by default. Toggle on to enable. When enabled, displays a custom
-  label for the :guilabel:`Value` number if the :guilabel:`Value Label`
-  option is also enabled. Displays a custom label for the Value Field tooltips.
+   * - Option
+     - Description
+     - Default
 
-- :guilabel:`Number Formatting`
+   * - :guilabel:`Label Override`
+     - When enabled, displays a custom label for the :guilabel:`Value`
+       number if the :guilabel:`Value Label` option is also enabled.
+       Displays a custom label for the Value Field tooltips.
+     - Off
 
-  Controls formatting of the large value in the chart, the tooltips,
-  and the min/max labels.
+   * - :guilabel:`Number Formatting`
+     - Controls formatting of the large value in the chart, the
+       tooltips, and the min/max labels.
+     - None
 
 Target Field
 ~~~~~~~~~~~~
 
-- :guilabel:`Label Override`
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 60 20
 
-  Off by default. Toggle on to enable. When enabled, displays a custom
-  label for the :guilabel:`Target` value if the :guilabel:`Target Label
-  & Value` option is also enabled. Displays a custom label for the Target
-  Field tooltips.
+   * - Option
+     - Description
+     - Default
 
-- :guilabel:`Number Formatting`
+   * - :guilabel:`Label Override`
+     - When enabled, displays  custom label for the :guilabel:`Target`
+       value if the :guilabel:`Target Label & Value` option is also
+       enabled. Displays a custom label for the Target Field tooltips.
+     - Off
 
-  Controls formatting of the Target value if it is displayed under the
-  chart.
+   * - :guilabel:`Number Formatting`
+     - Controls formatting of the Target value if it is displayed under
+       the chart.
+     - None
 
 .. _target-max: