(DOCSP-13246) First draft of preview docs (#4)

Author: zach-carr

snooty.toml

@@ -44,6 +44,7 @@ epoch-time-ms = "timestamp in the number of milliseconds that have elapsed since
 Epoch-time = "Timestamp in the number of seconds that have elapsed since the `UNIX epoch <https://en.wikipedia.org/wiki/Unix_time?oldid=828172017>`__"
 epoch-time = "timestamp in the number of seconds that have elapsed since the `UNIX epoch <https://en.wikipedia.org/wiki/Unix_time?oldid=828172017>`__"
 fcv = ":abbr:`FCV (Feature Compatibility Version)`"
+fedramp = "`FedRAMP <https://www.fedramp.gov/>`__"
 fqdn = ":abbr:`FQDN (fully qualified domain name)`"
 fts = "Atlas Search"
 gcp = ":abbr:`GCP (Google Cloud Platform)`"

source/getting-started.txt

@@ -14,37 +14,19 @@ Getting Started
    :depth: 1
    :class: singlecol
 
-Overview
---------
-
-|govcloud| provides a FedRAMP Moderate-compliant |service| environment 
-to host and manage your data in the cloud. This tutorial guides you 
-through creating an |govcloud-short| cluster, connecting to it, 
-inserting data, and querying data.
-
-Table of Contents
------------------
-
-- **Part 1:** :doc:`Create a MongoDB GovCloud Account </tutorial/create-account>`.
-- **Part 2:** :doc:`Deploy a Cluster </tutorial/deploy-cluster>`.
-- **Part 3:** :doc:`Allow Your Connection IP Address 
-  </tutorial/allow-connection-ip-address>`.
-- **Part 4:** :doc:`Create a Database User for Your Cluster 
-  </tutorial/create-mongodb-user-for-cluster>`.
-- **Part 5:** :doc:`Connect to Your Cluster </tutorial/connect-to-your-cluster>`.
-- **Part 6:** :doc:`Insert and View Data in Your Cluster 
-  </tutorial/insert-data-into-your-cluster>`.
-
-
-.. class:: hidden
-
-   .. toctree::
-      :titlesonly:
-
-      /tutorial/create-account
-      /tutorial/deploy-cluster
-      /tutorial/allow-connection-ip-address
-      /tutorial/create-mongodb-user-for-cluster
-      /tutorial/connect-to-your-cluster
-      /tutorial/insert-data-into-your-cluster
+|govcloud| provides an |service| environment for the U.S. government 
+(federal agencies and state, local, and education (SLED) entities)
+to host and manage data in the cloud. 
+
+This tutorial guides you through creating a |govcloud-short| account, 
+organization and cluster.
+
+.. toctree::
+   :titlesonly:
+
+   /tutorial/create-account
+   /tutorial/create-cluster
+   /tutorial/allow-ip
+   /tutorial/create-mongodb-user-for-cluster
+   /tutorial/connect-to-your-cluster
 

source/images/cloudgov-indicator.png

@@ -0,0 +1,22 @@
+|govcloud| clusters support :ref:`Cluster Auto-Scaling
+<cluster-autoscaling>`. When auto-scaling is enabled, |service|
+automatically scales your cluster tier, storage capacity, or both in
+response to cluster usage. Consider enabling auto-scaling to allow your
+cluster to adapt to your current workload and reduce the need to make
+manual optimizations.
+
+- :ref:`Cluster storage scaling <howitworks-scale-cluster-storage>`
+  automatically increases your cluster storage capacity when 90% of disk
+  capacity is used. This setting is on by default to help ensure that
+  your cluster can always support sudden influxes of data.
+
+- :ref:`Cluster tier scaling <howitworks-scale-cluster-tier>`
+  automatically scales your cluster tier up or down in response to
+  various cluster metrics. You must manually opt-in to cluster tier
+  scaling.
+  
+  When you enable cluster tier scaling, you set:
+    
+  - A maximum cluster tier to which your cluster can automatically
+    scale up, and
+  - *(Optional)* A minimum tier to which your cluster can scale down.

source/includes/admonitions/no-commercial-region.rst

@@ -0,0 +1,8 @@
+.. [#data-bearing]
+
+   For replica sets, the data-bearing servers are the servers hosting 
+   the replica set nodes. For sharded clusters, the data-bearing 
+   servers are the servers hosting the shards. For sharded clusters, 
+   |service| also deploys servers for the 
+   :ref:`config servers <sharding-config-server>`; these are charged at 
+   a rate separate from the cluster costs.

source/includes/admonitions/no-free-tier.rst

@@ -0,0 +1,28 @@
+title: "Click :guilabel:`Connect`."
+ref: getting-started-ip-connect
+stepnum: 1
+level: 4
+content: |
+  In the :guilabel:`Clusters` view, click :guilabel:`Connect` for the 
+  cluster to which you want to connect.
+
+  Atlas highlights the :guilabel:`Setup connection security` step.
+
+---
+title: "Click :guilabel:`Add Your Current IP Address`."
+ref: getting-started-ip-add
+stepnum: 2
+level: 4
+content: |
+  To secure your |govcloud-short| cluster, limit access to specified IP addresses.
+
+  The menu expands to show the :guilabel:`Add a connection IP address` 
+  modal.
+  
+---
+title: "Click :guilabel:`Add IP Address`."
+ref: getting-started-ip-confirm
+stepnum: 3
+level: 4
+
+...

source/includes/admonitions/require-scram-sha256.rst

@@ -0,0 +1,38 @@
+title: "Accept the email offer to create a |govcloud| account."
+level: 4
+ref: getting-started-accept-invite
+stepnum: 1
+
+---
+title: "Provide information about yourself."
+ref: getting-started-user-info
+level: 4
+stepnum: 2
+content: |
+ 
+  Provide the following information about yourself:
+  
+  - :guilabel:`Email Address`
+  - :guilabel:`First Name`
+  - :guilabel:`Last Name`
+  - :guilabel:`Password`
+  - :guilabel:`Country`
+
+---
+title: "Review and accept the |govcloud| :guilabel:`Privacy Policy` and
+  the :guilabel:`Terms of Service`."
+ref: getting-started-tos
+level: 4
+stepnum: 3
+
+---
+title: "Click :guilabel:`Sign Up` to create your account."
+ref: getting-started-sign-up
+level: 4
+stepnum: 4
+content: |
+  .. important::
+
+     You cannot change the email address that you use to log in to your
+     |govcloud-short| account after registering.
+...