copy review

Author: melissamahoney-mongodb

README.md

@@ -15,7 +15,7 @@ If you are a MongoDB Enterprise customer, or need Enterprise features such as Ba
 
 ## Documentation
 
-See the [`/docs`](/docs) directory to view documentation on how to:
+See the [documentation](/docs) to learn how to:
 
 1. [Install or upgrade](/docs/install-upgrade.md) the Operator.
 1. [Deploy and configure](/docs/deploy-configure.md) MongoDB resources.
@@ -26,15 +26,15 @@ See the [`/docs`](/docs) directory to view documentation on how to:
 
 The MongoDB Community Kubernetes Operator supports the following features:
 
-- MongoDB Topology: [replica sets](https://docs.mongodb.com/manual/replication/)
-- Upgrading and downgrading MongoDB server version
-- Scaling replica sets up and down
-- Reading from and writing to the replica set while scaling, upgrading, and downgrading. These operations are done in an "always up" manner.
-- Reporting of MongoDB server state via the [MongoDB resource](/deploy/crds/mongodb.com_mongodb_crd.yaml) `status` field
-- Use of any of the available [Docker MongoDB images](https://hub.docker.com/_/mongo/)
-- Clients inside the Kubernetes cluster can connect to the replica set (no external connectivity)
-- TLS support for client-to-server and server-to-server communication
-- Creating users with SCRAM-SHA authentication
+- Create [replica sets](https://docs.mongodb.com/manual/replication/)
+- Upgrade and downgrade MongoDB server version
+- Scale replica sets up and down
+- Read from and write to the replica set while scaling, upgrading, and downgrading. These operations are done in an "always up" manner.
+- Report MongoDB server state via the [MongoDB resource](/deploy/crds/mongodb.com_mongodb_crd.yaml) `status` field
+- Use any of the available [Docker MongoDB images](https://hub.docker.com/_/mongo/)
+- Connect to the replica set from inside the Kubernetes cluster (no external connectivity)
+- Secure client-to-server and server-to-server connections with TLS
+- Create users with [SCRAM](https://docs.mongodb.com/manual/core/security-scram/) authentication
 
 ### Planned Features
 - Server internal authentication via keyfile
@@ -43,8 +43,8 @@ The MongoDB Community Kubernetes Operator supports the following features:
 
 Before you contribute to the MongoDB Community Kubernetes Operator, please read:
 
-- [MongoDB Community Kubernetes Operator Architecture](docs/architecture.md)
-- [Contributing to MongoDB Community Kubernetes Operator](docs/contributing.md)
+- [MongoDB Community Kubernetes Operator Architecture](/docs/architecture.md)
+- [Contributing to MongoDB Community Kubernetes Operator](/docs/contributing.md)
 
 Please file issues before filing PRs. For PRs to be accepted, contributors must sign our [CLA](https://www.mongodb.com/legal/contributor-agreement).
 

docs/README.md

@@ -0,0 +1,10 @@
+# MongoDB Community Kubernetes Operator Documentation #
+
+# Table of Contents
+
+- [Contribute to the MongoDB Kubernetes Operator](/docs/contributing.md)
+- [MongoDB Community Kubernetes Operator Architecture](/docs/architecutre.md)
+- [Install and Upgrade the Community Kubernetes Operator](/docs/install-upgrade.md)
+- [Deploy and Configure MongoDB Resources](/docs/deploy-configure.md)
+- [Create Database Users](/docs/users.md)
+- [Secure MongoDB Resources](/docs/secure.md)

docs/secure.md

@@ -3,8 +3,8 @@
 ## Table of Contents
 
 - [Secure MongoDB Resource Connections using TLS](#secure-mongodb-resource-connections-using-tls)
-  - [Prerequisites](#prerequisites-1)
-  - [Procedure](#procedure-1)
+  - [Prerequisites](#prerequisites)
+  - [Procedure](#procedure)
 
 ## Secure MongoDB Resource Connections using TLS
 

docs/users.md

@@ -1,6 +1,6 @@
 # Create a Database User #
 
-You can create a MongoDB database user to authenticate to your MongoDB resource using SCRAM. First, [create a Kubernetes secret](#create-a-user-secret) for the new user's password. Then, [modify and apply the MongoDB CRD](#modify-the-mongodb-crd).
+You can create a MongoDB database user to authenticate to your MongoDB resource using [SCRAM](https://docs.mongodb.com/manual/core/security-scram/). First, [create a Kubernetes secret](#create-a-user-secret) for the new user's password. Then, [modify and apply the MongoDB CRD](#modify-the-mongodb-crd).
 
 You cannot disable SCRAM authentication.
 
@@ -19,7 +19,8 @@ You cannot disable SCRAM authentication.
        password: <my-plain-text-password> # corresponds to spec.users.passwordSecretRef.key in the MongoDB CRD
      ...
      ```
-1. Update `metadata.name` with the name of the secret and `stringData.password` with the user's password.
+1. Update the value of `metadata.name` with any name for this secret.
+1. Update the value of `stringData.password` with the user's password.
 1. Save the secret with a `.yaml` file extension.
 1. Apply the secret in Kubernetes:
    ```
@@ -72,7 +73,7 @@ You cannot disable SCRAM authentication.
    ```
    kubectl apply -f <mongodb-crd>.yaml --namespace <my-namespace>
    ```
-1. Once the MongoDB resource is running, securely store the user's password and then delete the user secret:
+1. After the MongoDB resource is running, securely store the user's password and then delete the user secret:
    ```
    kubectl delete secret <db-user-secret> --namespace <my-namespace>
    ```