(DOCSP-15133) User can create gov-only projects (#7)

zach-carr · web-flow · commit 61d3de4b8721 · 2021-04-06T12:31:25.000-04:00
* (DOCSP-15133) Users can create gov-only projects
diff --git a/source/atlas-access.txt b/source/atlas-access.txt
@@ -0,0 +1,22 @@
+.. _atlas-access:
+
+=====================
+|service| User Access
+=====================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+To access |service| in |govcloud|, you must have an |govcloud-short| 
+account.
+
+.. toctree::
+   :titlesonly:
+
+   /atlas-access/organizations
+   /atlas-access/projects
diff --git a/source/atlas-access/projects.txt b/source/atlas-access/projects.txt
@@ -0,0 +1,47 @@
+========
+Projects
+========
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+This tutorial is limited to creating a |govcloud-short| project.
+
+.. seealso:: |service| documentation
+
+   To learn more about projects, including how to move and delete them, 
+   see :atlas:`Projects </tutorial/manage-projects/>`.
+
+.. _create-project:
+
+Create a Project
+----------------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+To create a project for an organization, you must be either an
+:authrole:`Organization Owner` or an
+:authrole:`Organization Project Creator`.
+
+.. note::
+   
+   When you create a project, you are added as an
+   :authrole:`Project Owner` for the project.
+
+Cloud for Government Considerations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/considerations/gov-commercial-regions.rst
+
+Procedure
+~~~~~~~~~
+
+To create a project for an organization:
+
+.. include:: /includes/steps/create-new-project.rst
diff --git a/source/includes/considerations/gov-commercial-regions.rst b/source/includes/considerations/gov-commercial-regions.rst
@@ -0,0 +1,4 @@
+You must designate projects for either commercial or government 
+(``gov``) region usage upon creation. You cannot deploy clusters 
+across government and commercial regions in the same project. |aws| 
+is the only cloud provider for ``gov`` regions.
diff --git a/source/includes/steps-create-new-project.yaml b/source/includes/steps-create-new-project.yaml
@@ -0,0 +1,61 @@
+title: "Navigate to the :guilabel:`Create a Project` page."
+stepnum: 1
+level: 4
+ref: project-nav-create-project
+content: |
+
+  a. If it is not already displayed, select the organization that
+     contains your desired project from the |ui-org-menu| in the
+     navigation bar.
+
+  #. Click the :guilabel:`Leaf` icon in the upper left corner of the
+     page or expand the :guilabel:`Projects` menu in the navigation
+     bar.
+
+  #. Click :guilabel:`New Project`.
+
+---
+title: "Name your new project."
+stepnum: 2
+level: 4
+ref: project-enter-name
+content: |
+
+  Enter the name for your new project.
+---
+title: "Designate your project for commercial or government region use."
+stepnum: 2
+level: 4
+ref: project-designate-gov
+content: |
+
+  a. Check :guilabel:`Designate as a Gov Cloud regions-only project` if 
+     you want to deploy clusters only to ``gov`` regions. Otherwise, 
+     you may deploy clusters only to commercial regions.
+  
+  b. Click :guilabel:`Next`.
+
+---
+title: "Add members."
+stepnum: 3
+level: 4
+ref: project-add-members
+content: |
+
+  a. For existing |govcloud-short| users, enter the email 
+     that the person used to register.
+
+  b. For new |govcloud-short| users, enter their email 
+     address to send an invitation.
+
+---
+title: "Specify the access for the members."
+stepnum: 4
+level: 4
+ref: project-specify-access
+---
+title: "Click :guilabel:`Create Project`."
+stepnum: 5
+level: 4
+ref: project-click-create
+...
diff --git a/source/index.txt b/source/index.txt
@@ -59,5 +59,6 @@ Links to |service| documentation pages are presented as either:
    /introduction
    /getting-started
    /security
+   /atlas-access
    /backup-restore-data
    /api
diff --git a/source/introduction/atlas-gov-considerations.txt b/source/introduction/atlas-gov-considerations.txt
@@ -38,15 +38,17 @@ To learn more about signing up for |govcloud-short|, see
 Available Regions
 -----------------
 
-- You may deploy clusters in isolated ``gov`` (government) regions. 
-  |aws| is the only cloud provider for |govcloud| regions.
+|govcloud-short| allows you to deploy clusters in government regions 
+that meet more stringent security standards.
 
-- You cannot deploy clusters across government and commercial 
-  regions in the same project.
+.. include:: /includes/considerations/gov-commercial-regions.rst
 
 To learn more about the regions available for |govcloud-short| 
 deployments, see :ref:`<supported-regions>`.
 
+To learn more about AWS ``gov`` regions, see the 
+:aws:`AWS documentation </govcloud-us/>`.
+
 |service| Clusters
 ------------------
 
diff --git a/source/introduction/supported-regions.txt b/source/introduction/supported-regions.txt
@@ -15,17 +15,13 @@ Supported Cloud Providers and Regions
 Cloud for Government Considerations
 -----------------------------------
 
-- You may deploy clusters in isolated ``gov`` (government) regions. 
-  |aws| is the only cloud provider for |govcloud| regions.
-
-- You cannot deploy clusters across government and commercial 
-  regions in the same project.
+.. include:: /includes/considerations/gov-commercial-regions.rst
 
 AWS Commercial
 --------------
 
 You can deploy a |govcloud| cluster in the following |aws| |fedramp| 
-Moderate compliant commercial regions:
+Moderate commercial regions:
 
 - Northern Virginia ``us-east-1``
 
diff --git a/source/security/private-endpoint.txt b/source/security/private-endpoint.txt
@@ -243,7 +243,7 @@ setting:
 Limitations
 -----------
 
-- You cannot deploy clusters across government and commercial regions.
+- .. include:: /includes/considerations/gov-commercial-regions.rst
 
 - {+aws-pl+} must be active in all regions into which you deploy
   a multi-region cluster. You will receive an error if {+aws-pl+}
diff --git a/source/tutorial/create-cluster.txt b/source/tutorial/create-cluster.txt
@@ -22,15 +22,14 @@ Cloud for Government Considerations
 
 - |govcloud-short| clusters must be tier ``M20`` or higher.
 
-- You cannot deploy clusters across government and commercial 
-  regions in the same project.
+- .. include:: /includes/considerations/gov-commercial-regions.rst
 
 Procedure
 ---------
 
 To deploy a cluster in |govcloud|:
 
-.. include:: includes/steps/create-cluster.rst
+.. include:: /includes/steps/create-cluster.rst
 
 .. include:: /includes/footnotes/data-bearing.rst
 
