DOCSP-35122 dashboard ownership (#636)

* added dashboard ownership steps

Author: kyuan-mongodb

source/dashboard-ownership.txt

@@ -0,0 +1,108 @@
+.. _dashboard-ownership:
+
+===================
+Dashboard Ownership
+===================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+You can :ref:`view <view-dashboard-owners>`, :ref:`add
+<add-dashboard-owners>`, or :ref:`remove <remove-dashboard-owners>`
+dashboard owners to any dashboard in your project.
+
+Prerequisites
+-------------
+
+You must have the :authrole:`Project Owner` role.
+
+.. _view-dashboard-owners:
+
+View Dashboard Owners
+---------------------
+
+To view the owners of any dashboard in your project:
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: Click :guilabel:`Charts` in the navigation bar to navigate to |charts|.
+
+   .. step:: Click :guilabel:`Owners` under :guilabel:`Dashboards` in the sidebar.
+
+      |charts| displays a table with the following columns:
+
+      .. list-table::
+         :header-rows: 1
+         :stub-columns: 1
+         :widths: 25 75
+
+         * - Column Name
+           - Description
+
+         * - :guilabel:`Dashboard title`
+           - Title of the dashboard.
+
+         * - :guilabel:`Dashboard ID`
+           - ``ID`` of the dashboard.
+
+         * - :guilabel:`Dashboard owners`
+           - Email associated with each dashboard owner.
+             
+             If an existing dashboard owner was the only owner, and
+             no longer has access to the project anymore, the
+             :guilabel:`Dashboard owners` column will say ``No owners``.
+
+      You can sort this table by the :guilabel:`Dashboard title` column.
+      If a dashboard owner omits the :guilabel:`Dashboard title`,
+      |charts| sorts by the :guilabel:`Dashboard ID`.
+
+.. _add-dashboard-owners:
+
+Add a Dashboard Owner
+---------------------
+
+To add a dashboard owner to a dashboard in your project:
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: Navigate to :ref:`view dashboard owners <view-dashboard-owners>`.
+
+   .. step:: Click the pencil icon :icon-fa4:`pencil` for the dashboard you want to add an owner to.
+   
+   .. step:: Type the email of the person you want to make an owner of the dashboard.
+
+      .. note:: 
+
+         This person must have at least ``Viewer`` :doc:`permissions
+         <dashboard-permissions>` on the dashboard.
+
+   .. step:: Click :guilabel:`Save`.
+
+.. _remove-dashboard-owners:
+
+Remove a Dashboard Owner
+------------------------
+
+To remove a dashboard owner from a dashboard in your project:
+
+.. procedure:: 
+   :style: normal
+
+   .. step:: Navigate to :ref:`view dashboard owners <view-dashboard-owners>`.
+
+   .. step:: Click the pencil icon :icon-fa4:`pencil` for the dashboard you want to remove an owner from.
+   
+   .. step:: Click the :guilabel:`x` next to the person's email that you want to remove.
+
+      .. note:: 
+
+         There must be at least one dashboard owner.
+
+   .. step:: Click :guilabel:`Save`.

source/dashboards.txt

@@ -361,6 +361,7 @@ tasks:
 .. toctree::
    :titlesonly:
 
+   /dashboard-ownership
    /manage-dashboards
    /dashboard-permissions
    /scheduled-reports