(DOCSP-17121) Finalize organization of content (#18)

* (DOCSP-17121) Finalize organization of content

Author: zach-carr

snooty.toml

@@ -5,7 +5,9 @@ intersphinx = ["https://docs.mongodb.com/manual/objects.inv","https://docs.atlas
 
 toc_landing_pages = [
   "/tutorial/getting-started",
-  "/security"
+  "/security",
+  "/clusters",
+  "/api"
 ]
 
 [constants]
@@ -17,7 +19,7 @@ see-service-docs = "See the Atlas Documentation"
 cloudgov = "MongoDB Atlas for Government"
 cloudgov-short = "AtlasGov"
 aws-fr-high = "AWS GovCloud"
-aws-fr-moderate = "AWS US East-West"
+aws-fr-moderate = "AWS Standard"
 2fa = ":abbr:`2FA (Two Factor Authentication)`"
 aki = ":abbr:`AKI (Azure Key Identifier)`"
 akv = ":abbr:`AKV (Azure Key Vault)`"

source/api.txt

@@ -1,5 +1,7 @@
 :noprevnext:
 
+.. _api:
+
 ===
 API
 ===
@@ -9,12 +11,19 @@ API
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 1
    :class: singlecol
 
+
 The |cloudgov| |api| supports a subset of |service| |api| endpoints. 
 Some endpoints use a different |url|.
 
+{+gov-considerations+}
+-----------------------------------
+
+- |api| users are required to use ``SHA-256`` in the |http| Digest 
+  Access Authentication.
+
 .. toctree::
    :titlesonly:
 

source/atlas-access.txt

@@ -1,4 +1,4 @@
-.. _atlas-access:
+.. _cloudgov-access:
 
 ============================
 |cloudgov-short| User Access
@@ -12,19 +12,79 @@
    :depth: 1
    :class: singlecol
 
-This page covers |cloudgov| user accounts.
+.. note::
 
-{+gov-considerations+}
+   This page covers |cloudgov| user accounts. |cloudgov-short| users 
+   are separate from database users. Database users can access MongoDB 
+   databases, while |cloudgov-short| users can access the 
+   |cloudgov-short| application itself.
+
+Create an |cloudgov-short| Account
 -----------------------------------
 
-Account
-~~~~~~~
+|cloudgov| is available by invitation only. To create a 
+|cloudgov-short| account, you must either:
+
+- Purchase a subscription and activate an account, or
+
+- Accept an invitation from an existing user in an existing 
+  organization.
+
+Purchase and Activate a Subscription
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To purchase and activate a |cloudgov-short| subscription, see 
+:ref:`billing`.
+
+Accept an Invitation
+~~~~~~~~~~~~~~~~~~~~
+
+|cloudgov-short| invitations are sent by email. To accept an invitation 
+to an organization, follow the instructions in the |cloudgov-short| 
+email you receive.
+
+Account Limitations
+-------------------
+
+- You cannot register for an |cloudgov-short| account through the login 
+  page or create an |cloudgov-short| account using the |api|. You must 
+  receive an activation code from MongoDB Sales or be invited to an 
+  existing organization.
+
+- You cannot use Google SSO credentials to sign up or log in.
+
+Account Security
+----------------
+
+Passwords
+~~~~~~~~~
+
+- |cloudgov-short| passwords expire after 60 days.
+
+- You can only change your password once each day.
 
 - When you change your password, you cannot use any of your previous 24 
   passwords.
 
-- If your account is suspended due to inactivity, reset your password 
-  to unsuspend your account.
+- |cloudgov-short| requires that passwords contain:
+
+  - At least 15 characters,
+  - An upper case letter,
+  - A lower case letter,
+  - A number, and
+  - A special character.
+
+Account
+~~~~~~~
+
+- After 3 failed login attempts your account is locked for 30 minutes, 
+  preventing further login attempts. You can contact support to unlock 
+  your account.
+
+- Your |cloudgov-short| account is considered inactive and suspended if 
+  you do not log in for 90 consecutive days. If your account is 
+  suspended due to inactivity, reset your password to unsuspend your 
+  account.
 
 User Sessions
 ~~~~~~~~~~~~~
@@ -33,13 +93,9 @@ User Sessions
   inactivity, requiring you to log in again. You are prompted to 
   continue your current session after 10 minutes of inactivity.
 
-Monitoring and Logging
-~~~~~~~~~~~~~~~~~~~~~~
-
-- You must have the :authrole:`Project Owner` role to 
-  configure an integration.
+Organizations and Projects
+--------------------------
 
-- In addition to :atlas:`standard Atlas logging </mongodb-logs/>`, 
-  |cloudgov-short| logs the username and IP address associated with all 
-  failed login attempts, temporary lockouts and failed |api| digest 
-  authentications.
+See the |service| documentation to learn more about using 
+:atlas:`Organizations and Projects </organizations-projects/#organizations-and-projects>` 
+to manage |cloudgov-short| user access.

source/atlas-search.txt

@@ -1,25 +1,42 @@
 .. _billing:
 
-=======
-Billing
-=======
+=========================
+Subscriptions and Billing
+=========================
 
 .. default-domain:: mongodb
 
 .. contents:: On this page
    :local:
    :backlinks: none
-   :depth: 2
+   :depth: 1
    :class: singlecol
 
+You must purchase a subscription to pay for |cloudgov|.
+
+Purchase a Subscription
+-----------------------
+
 You can purchase a |cloudgov| subscription from the following 
 sources:
 
-- The AWS marketplace
+- The |aws| Marketplace
 
 - :website:`MongoDB Sales </contact/atlas>`
 
+Activate Your Subscription
+--------------------------
+
+Activate your subscription by accepting the email invitation sent to 
+you by the |aws| Marketplace or MongoDB Sales.
+
+When you accept an invitation to register for a new account, your 
+activation code is applied to the first organization you create.
+
 Limitations
 -----------
 
-You cannot use a credit card or PayPal to pay for |cloudgov-short|.
+- Elastic invoicing is not available.
+
+- You cannot use a credit card or PayPal to pay for |cloudgov-short|. 
+  Credit card alerts are disabled.

source/billing.txt

@@ -1,8 +1,8 @@
-.. _intro-purchase-subscription:
+.. _subscriptions:
 
-==========================================
-Purchase a |cloudgov-short| Subscription
-==========================================
+=========================
+Subscriptions and Billing
+=========================
 
 .. default-domain:: mongodb
 
@@ -12,6 +12,12 @@ Purchase a |cloudgov-short| Subscription
    :depth: 1
    :class: singlecol
 
+You must purchase a subscription to use |cloudgov|. Elastic invoicing 
+is not available.
+
+Purchase a Subscription
+-----------------------
+
 You can purchase a |cloudgov| subscription from the following 
 sources:
 
@@ -22,7 +28,8 @@ sources:
 Activate Your Subscription
 --------------------------
 
-Placeholder for procedure.
+Activate your subscription using the activation code you receive after 
+purchase.
 
 To learn more about |cloudgov-short| subscriptions, see 
 :ref:`billing`.

source/tutorial/purchase-subscription.txt renamed to source/billing/subscriptions.txt

@@ -0,0 +1,36 @@
+.. _clusters:
+
+========
+Clusters
+========
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Clusters are |cloudgov|\-managed MongoDB deployments. A cluster can be
+either a :term:`replica set` or a :term:`sharded cluster`.
+
+{+gov-considerations+}
+-----------------------------------
+
+- When you create a project, you may designate it as a government 
+  region-only project. If you do not, that project is a standard 
+  region-only project. You may only deploy clusters to the type of 
+  region that your project supports.
+
+- You may only create clusters tier ``M20`` and above. Free and shared 
+  tier clusters are not available.
+
+See the |service| documentation to
+:atlas:`Configure Clusters </cluster-configuration/>`.
+
+.. toctree::
+   :titlesonly:
+   
+   /clusters/monitoring
+   /clusters/backup-restore-data

source/clusters.txt

@@ -1,3 +1,5 @@
+.. _backup-restore:
+
 ===============================
 Backup and Restore Cluster Data
 ===============================
@@ -14,24 +16,21 @@ Backups are copies of your data that encapsulate the state of your
 cluster at a given time. Backups provide a safety measure in the
 event of data loss.
 
-.. note::
+You must have the :authrole:`Project Owner` role for an 
+|cloudgov-short| project to manage backups for or to restore a 
+backup to clusters in that project.
 
-   You must have the :authrole:`Project Owner` role for an 
-   |cloudgov-short| project to manage backups for or to restore a 
-   backup to clusters in that project.
+.. tip::
 
-{+gov-considerations+}
------------------------------------
+   |cloudgov-short| user roles are the same as 
+   :atlas:`Atlas User Roles </reference/user-roles/>`.
 
-Commercial and government cloud provider backups are not compatible 
-with each other. If you create a backup from a government region-only 
+Standard and government cloud provider backups are not compatible 
+with one another. If you create a backup from a government region-only 
 project, you may only restore that data to a government region-only 
-project. The same is true for commercial region-only projects.
+project. The same is true for standard region-only projects.
 
 For a list of regions by cloud provider, see :ref:`<supported-regions>`.
 
-{+see-service-docs+}
----------------------------
-
 See the |service| documentation to configure 
-:atlas:`Cloud Backups </backup/cloud-backup/overview/>`.
+:atlas:`Cloud Backups </backup/cloud-backup/overview/>`

source/backup-restore-data.txt renamed to source/clusters/backup-restore-data.txt

@@ -0,0 +1,60 @@
+.. _monitoring:
+
+==============================
+Monitoring, Logging and Alerts
+==============================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Monitoring
+----------
+
+You must have the :authrole:`Project Owner` role to 
+configure a third-party monitoring integration.
+
+.. tip::
+
+   |cloudgov-short| user roles are the same as 
+   :atlas:`Atlas User Roles </reference/user-roles/>`.
+
+See the |service| documentation to 
+:atlas:`Integrate with Third-Party Monitoring Services </tutorial/third-party-service-integrations/>`
+
+Logging
+-------
+
+In addition to the standard Atlas logging, 
+|cloudgov-short| logs the username and IP address associated with all 
+failed login attempts, temporary lockouts and failed |api| digest 
+authentications.
+
+See the |service| documentation to 
+:atlas:`View and Download MongoDB Logs </mongodb-logs/>`
+
+Alerts and Communications
+-------------------------
+
+You receive emails from a different MongoDB account depending on the 
+region to which your resources are deployed and the type of 
+communication.
+
+|aws-fr-moderate|
+~~~~~~~~~~~~~~~~~
+
+- Alerts come from ``[email protected]``.
+- All other emails come from ``[email protected]``.
+
+|aws-fr-high|
+~~~~~~~~~~~~~
+
+- Alerts come from ``[email protected]``.
+- All other emails come from ``[email protected]``.
+
+See the |service| documentation to 
+:atlas:`Configure and Resolve Alerts </alerts/>`