(DOCSP-12849): Customize scatter mark size (#425)

* (DOCSP-12849): Customize scatter mark scale

* copy tweak

Co-authored-by: Jeff Allen <[email protected]>

Author: jeff-allen-mongo

snooty.toml

@@ -10,9 +10,7 @@ toc_landing_pages = ["/installation", "/dashboards", "/data-sources",
                      "/tutorial/movie-details/movie-details-tutorial-overview", 
                      "/chart-types", "/chart-type-reference/data-table", 
                      "/chart-type-reference/geo-spatial", 
-                     "/chart-type-reference/choropleth", 
-                     "/chart-type-reference/grid-charts", 
-                     "/chart-type-reference/circular-charts", 
+                     "/chart-type-reference/choropleth",
                      "/customize-charts", "/embedding-charts", 
                      "/view-export-chart-data", 
                      "/embedding-tutorials",

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

@@ -6,21 +6,19 @@ Circular Charts
 
 .. default-domain:: mongodb
 
-.. class:: toc
+:doc:`/chart-type-reference/donut-chart/`
+   .. include:: /includes/donut-blurb.rst
+   
+   .. figure:: /images/charts/donut-simple-example.png
+      :figwidth: 500px
+      :alt: Example of a donut chart
 
-   :doc:`/chart-type-reference/donut-chart/`
-      .. include:: /includes/donut-blurb.rst
-      
-      .. figure:: /images/charts/donut-simple-example.png
-         :figwidth: 545
-         :alt: Example of a donut chart
-
-   :doc:`/chart-type-reference/gauge-chart/`
-      .. include:: /includes/gauge-blurb.rst
-      
-      .. figure:: /images/charts/gauge-chart.png
-         :figwidth: 551
-         :alt: Example of a gauge chart
+:doc:`/chart-type-reference/gauge-chart/`
+   .. include:: /includes/gauge-blurb.rst
+   
+   .. figure:: /images/charts/gauge-chart.png
+      :figwidth: 500px
+      :alt: Example of a gauge chart
 
 .. toctree::
    :titlesonly:

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

@@ -39,6 +39,10 @@ Scatter charts provide the following :ref:`encoding channels
        changes the size of the data point markers, with larger sizes
        indicating larger aggregated values.
 
+       .. seealso::
+
+          :ref:`Customize Mark Size <customize-scatter-marks>`
+
    * - Color
      - *(Optional)* A :guilabel:`category` encoding channel that changes
        the color of the data point markers based on the value of the
@@ -85,12 +89,31 @@ Consider using a scatter chart to display:
 - Volume of sales data for selected retail outlets
 - Population density figures across several countries
 
+.. _customize-scatter-chart:
 
-Limitations
------------
+Customization Options
+---------------------
 
-The maximum query response size for a scatter chart is 50000 documents.  
+The following customization options are specific to scatter charts. To
+see all available customization options, see :ref:`customize-charts`.
+
+.. _customize-scatter-marks:
+
+Mark Size
+~~~~~~~~~
+
+Adjust the size of the scatter marks. This option behaves differently
+based on whether you have a field mapped to the :guilabel:`Size`
+encoding channel.
 
+- If you do not have a field mapped to :guilabel:`Size`, the
+  :guilabel:`Mark Size` setting changes the size of the marks linearly
+  based on the chosen value.
+
+- If you have a field mapped to :guilabel:`Size`, the
+  :guilabel:`Mark Size` setting changes the size of the largest mark,
+  and also controls the difference between the smallest and largest
+  marks.
 
 Examples
 --------
@@ -138,4 +161,9 @@ year, which would make the chart too noisy to read.
 
 .. figure:: /images/charts/scatter-chart-movie-details.png
    :figwidth: 750px
-   :alt: Scatter chart example 
+   :alt: Scatter chart example
+
+Limitations
+-----------
+
+The maximum query response size for a scatter chart is 50000 documents.  

source/customize-charts.txt

@@ -1,3 +1,5 @@
+.. _customize-charts:
+
 ================
 Customize Charts
 ================