(DOCSP-26064) Org-wide data source and deployment sharing (#573)

* (DOCSP-26064) Org-wide data source and deployment sharing

Author: zach-carr

source/includes/fact-org-wide-sharing.rst

@@ -0,0 +1,7 @@
+Organization-wide sharing grants users in your organization, including 
+users who are not members of your project, permission to view data in a 
+deployment that is used for dashboards shared with your organization.
+
+You can enable organization-wide sharing 
+:ref:`for an entire deployment <org-sharing-deployment>` or 
+:ref:`for a specific data source <org-sharing-data-source>`.

source/includes/steps-access-deployment.txt renamed to source/includes/steps-access-deployment.rst

@@ -47,4 +47,4 @@
         - Label that indicates the |service| :ref:`{+cluster+} tier
           <create-cluster-instance>` for the deployment. |charts-short|
           doesn't display :guilabel:`Tier` for {+fdis+} and 
-          {+serverless-instances+}.
+          {+serverless-instances+}.

source/includes/steps-connect-deployment.txt renamed to source/includes/steps-connect-deployment.rst

@@ -13,4 +13,4 @@
 
    The deployment connects and the :guilabel:`Data Access` section
    displays all of the databases for the selected |service|
-   deployment.
+   deployment.

source/manage-data-sources.txt

@@ -29,7 +29,7 @@ To access the data source's settings page:
 
    .. include:: /includes/steps-access-deployment.rst
 
-   .. step:: In the :guilabel:`Data Access` section, click the name of the database that contains the data source.
+   .. step:: In the :guilabel:`Data Access` section, under :guilabel:`Deployment`, click the name of the database that contains the data source.
 
       A list of the database's data sources appears.
 
@@ -60,6 +60,28 @@ Modify Data Source Permissions
 
 If you have the :authrole:`Project Owner` role, you can control who can see charts that use the data source.
 
+.. _org-sharing-data-source:
+
+Enable Organization-Wide Sharing for a Data Source
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/fact-org-wide-sharing.rst
+
+To enable organization-wide sharing for a specific data source:
+
+.. procedure::
+   :style: normal
+
+   .. step:: Access the data source's settings page.
+
+      To learn more, see :ref:`access-data-source-settings-page`.
+
+   .. step:: Turn on organization-wide sharing.
+    
+      In the :guilabel:`Organization` subsection of the 
+      :guilabel:`Data Access` section, toggle 
+      :guilabel:`All users in the organization can view data in this data source` to :guilabel:`ON`.
+
 Enable External Sharing for a Data Source
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -147,8 +169,8 @@ To disable external sharing for a data source:
 .. _data-source-specific-access:
 .. _data-source-access-everyone:
 
-Modify Data Source Permissions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Modify Role Permissions for Data Sources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you have the :authrole:`Project Owner` role, you can modify data source permissions for each project role. Data source permissions determine whether a user can view charts created using data in this data source.
 

source/manage-deployment.txt

@@ -6,12 +6,6 @@ Manage Deployments
 
 .. default-domain:: mongodb
 
-.. contents:: On this page
-   :local:
-   :backlinks: none
-   :depth: 1
-   :class: singlecol
-
 On the :guilabel:`Data Sources` page, an |service| 
 :authrole:`Project Owner` can manage a deployment. 
 
@@ -34,6 +28,32 @@ its data sources. To learn more, see
 
 To manage other data source settings, see :ref:`manage-existing-data-sources`.
 
+.. _org-sharing-deployment:
+
+Enable Organization-Wide Sharing for a Deployment
+-------------------------------------------------
+
+.. include:: /includes/fact-org-wide-sharing.rst
+
+.. important::
+
+   If you enable organization-wide sharing for a deployment, it applies 
+   to all existing data sources and to any new data source you add to 
+   that deployment in the future.
+
+To enable organization-wide sharing for a deployment:
+
+.. procedure::
+   :style: normal
+
+   .. include:: /includes/steps-access-deployment.rst
+
+   .. step:: Turn on organization-wide sharing.
+    
+      In the :guilabel:`Organization` subsection of the 
+      :guilabel:`Data Access` section, toggle 
+      :guilabel:`All users in the organization can view data in this data source` to :guilabel:`ON`.
+
 Deployment Read Preference
 --------------------------
 
@@ -82,4 +102,4 @@ preference options for {+clusters+}:
        :manual:`/core/read-preference/#mongodb-readmode-nearest`.
 
    * - Analytics Node
-     - Reads from an :ref:`anayltics node <analytics-nodes-overview>`.
+     - Reads from an :ref:`anayltics node <analytics-nodes-overview>`.