(DOCSP-4643): Refactor data table and data source pages

Author: jeff-allen-mongo

config/sphinx_local.yaml

@@ -21,6 +21,7 @@ theme:
      - /tutorial/order-data/order-data-tutorial-overview
      - /tutorial/movie-details/movie-details-tutorial-overview
      - /chart-types
+     - /chart-type-reference/data-table
      - /customize-charts
 sidebars:
   '**':

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

@@ -161,106 +161,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``.
 
-Sort and Resize Data Table Columns
-----------------------------------
+.. class:: hidden
 
-Users with the viewer and author :ref:`roles <dashboard-roles>`
-on data tables can sort and resize data table columns. You
-can sort and resize columns either in the
-:doc:`dashboard </dashboards>` or the :doc:`Chart Builder
-</build-charts>`.
+   .. toctree::
+      :titlesonly:
 
-Behavior
-~~~~~~~~
-
-When a viewer or author sorts or resizes columns from the
-:doc:`dashboard </dashboards>`, the changes do not persist as part of
-the chart definition. In this case, the chart returns to its
-original state once the chart or corresponding dashboard is
-refreshed.
-
-To save the changes as part of the chart definition, an author must
-make the changes in the Chart Builder. All |charts-short| users will
-see the new column sorting and sizing.
-
-Procedure
-~~~~~~~~~
-
-Sort Columns
-````````````
-
-To sort a data table column, click on its header. With each click, |charts| cycles between sorting the column in
-ascending order, descending order, and the default chart sorting order.
-
-To sort by multiple columns, Shift + Click on the additional columns
-by which you wish to sort. |charts-short| applies the sort order in
-the same order you select additional columns. |charts-short| displays
-numbers in the column headers indicating the order in which the
-sorting is applied.
-
-Resize Columns
-``````````````
-
-To resize a column, click the the column divider and drag until the
-column reaches the desired width.
-
-To return a column to its default width, double-click on the column
-divider.
-
-Reorder Data Table Columns
---------------------------
-
-Users with the author and owner :ref:`roles <dashboard-roles>`
-on data tables can reorder data table columns in the :doc:`Chart
-Builder </build-charts>`.
-
-To reorder data table columns, click and drag column headers to the
-desired order.
-
-When an author reorders data table columns and saves the
-chart, |charts| saves the specified order as part of the chart
-definition. All |charts-short| users will see the new column order.
-
-.. note::
-
-   Data table :ref:`authors <dashboard-roles>` can also reorder
-   columns by modifying the order of the respective column
-   :ref:`encoding channels <encoding-channels>`. |charts| renders data
-   table columns in the same order you specify the column encoding
-   channels. To modify the order of the encoding channels, drag and
-   drop one field on top of another to swap their order.
-
-Considerations
-~~~~~~~~~~~~~~
-
-- You can only reorder columns within their respective table sections,
-  being :guilabel:`Groups` or :guilabel:`Values`.
-
-- You cannot reorder :guilabel:`Dynamic Columns`.
-
-Toggle Row and Column Totals
-----------------------------
-
-By default, data tables include a Column Totals row, which consists of
-a row of values with sum totals for each column. Optionally, you can
-enable a Row Totals column, which consists of a column of
-values containing sum totals for each row.
-
-The following image shows a detail from a data table with row and
-column totals enabled and added text indicating which is which:
-
-.. figure:: /images/charts/row-column-totals.png
-   :figwidth: 541px
-   :alt: Data table with row and column totals
-
-To toggle the totals on and off:
-
-1. Navigate to the :guilabel:`Customization` tab in the
-   :doc:`Chart Builder </build-charts>`.
-
-#. In the :guilabel:`General Customization` section, set the
-   :guilabel:`Column Totals` and :guilabel:`Row Totals` toggles
-   to the desired settings.
-
-For a complete list of Chart Customization options, see :doc:`Customize
-Charts </customize-charts/>`.
+      /chart-type-reference/data-table/reorder-columns
+      /chart-type-reference/data-table/sort-resize-columns
+      /chart-type-reference/data-table/toggle-row-column-totals

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

@@ -0,0 +1,47 @@
+.. _reorder-data-table-columns:
+
+==========================
+Reorder Data Table Columns
+==========================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Users with the author and owner :ref:`roles <dashboard-roles>`
+on data tables can reorder data table columns in the :doc:`Chart
+Builder </build-charts>`.
+
+Behavior
+--------
+
+When a user reorders data table columns and saves the
+chart, |charts| saves the specified order as part of the chart
+definition. All |charts-short| users will see the new column order.
+
+Procedure
+---------
+
+To reorder data table columns, click and drag column headers to the
+desired order.
+
+.. note::
+
+   Data table :ref:`authors and owners <dashboard-roles>` can also
+   reorder columns by modifying the order of the respective column
+   :ref:`encoding channels <encoding-channels>`. |charts| renders data
+   table columns in the same order you specify the column encoding
+   channels. To modify the order of the encoding channels, drag and
+   drop one field on top of another to swap their order.
+
+Considerations
+--------------
+
+- You can only reorder columns within their respective table sections,
+  being :guilabel:`Groups` or :guilabel:`Values`.
+
+- You cannot reorder :guilabel:`Dynamic Columns`.

source/chart-type-reference/data-table/sort-resize-columns.txt

@@ -0,0 +1,56 @@
+.. _sort-resize-data-table-columns:
+
+==================================
+Sort and Resize Data Table Columns
+==================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Users with the viewer and author :ref:`roles <dashboard-roles>`
+on data tables can sort and resize data table columns. You
+can sort and resize columns either in the
+:doc:`dashboard </dashboards>` or the :doc:`Chart Builder
+</build-charts>`.
+
+Behavior
+--------
+
+When a viewer or author sorts or resizes columns from the
+:doc:`dashboard </dashboards>` view, the changes do not persist as
+part of the chart definition. In this case, the chart returns to its
+original state once the chart or corresponding dashboard is
+refreshed.
+
+To save the changes as part of the chart definition, an author must
+make the changes in the Chart Builder. All |charts-short| users will
+see the new column sorting and sizing.
+
+Procedure
+---------
+
+Sort Columns
+~~~~~~~~~~~~
+
+To sort a data table column, click on its header. With each click, |charts| cycles between sorting the column in
+ascending order, descending order, and the default chart sorting order.
+
+To sort by multiple columns, Shift + Click on the additional columns
+by which you wish to sort. |charts-short| applies the sort order in
+the same order you select additional columns. |charts-short| displays
+numbers in the column headers indicating the order in which the
+sorting is applied.
+
+Resize Columns
+~~~~~~~~~~~~~~
+
+To resize a column, click the the column divider and drag until the
+column reaches the desired width.
+
+To return a column to its default width, double-click on the column
+divider.

source/chart-type-reference/data-table/toggle-row-column-totals.txt

@@ -0,0 +1,32 @@
+.. _toggle-row-column-totals:
+
+=======================================
+Toggle Data Table Row and Column Totals
+=======================================
+
+By default, data tables include a Column Totals row, which consists of
+a row of values with sum totals for each column. Optionally, you can
+enable a Row Totals column, which consists of a column of
+values containing sum totals for each row.
+
+The following image shows a detail from a data table with row and
+column totals enabled and added text indicating which is which:
+
+.. figure:: /images/charts/row-column-totals.png
+   :figwidth: 541px
+   :alt: Data table with row and column totals
+
+Procedure
+---------
+
+To toggle the totals on and off:
+
+1. Navigate to the :guilabel:`Customization` tab in the
+   :doc:`Chart Builder </build-charts>`.
+
+#. In the :guilabel:`General Customization` section, set the
+   :guilabel:`Column Totals` and :guilabel:`Row Totals` toggles
+   to the desired settings.
+
+For a complete list of Chart Customization options, see :doc:`Customize
+Charts </customize-charts/>`.