(DOCSP-8189): TOC refactor (#173)

* (DOCSP-8235): Refactor TOC and create shell pages for new topics

* (DOCSP-8315): Break up TOC files

* TOC cleanup

* Create new definition list landing pages for tocs

* (DOCSP-8284): Rename topic titles to distinguish between OM and database resources

* (DOCSP-8314): Restructure includes folder

* (DOCSP-8286): Create “Plan your Ops Manager resource” conceptual page

* (DOCSP-8285): Create “Deploy Ops Manager resources” conceptual page

* Copy/tech review

* Tech review 2

Author: melissamahoney-mongodb

source/configure-k8s-operator-for-mdb-resources.txt

@@ -2,9 +2,9 @@
 
 .. _configure-k8s-op-mdb-resources:
 
-==================================================
-Configure the |k8s-op-short| for MongoDB Resources
-==================================================
+===========================================================
+Configure the |k8s-op-short| for MongoDB Database Resources
+===========================================================
 
 .. default-domain:: mongodb
 
@@ -14,9 +14,17 @@ Configure the |k8s-op-short| for MongoDB Resources
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/toc/dfn-list-configure-k8s-operator-for-mdb-resources.rst
+:ref:`create-k8s-credentials`
+  Create a |k8s-secret| so the |k8s-op-short| can create and update
+  |k8s-objs| in your |com| Project.
 
-.. include:: /includes/toc/configure-k8s-operator-for-mdb-resources.rst
+:ref:`create-k8s-project`
+  Create a |k8s-configmap| to link the |k8s-op-short| to your |com|
+  Project.
+
+:ref:`create-x509-certs`
+  Create an X.509 certificate to connect to an X.509-enabled
+  MongoDB deployment.
 
 .. class:: hidden
 

source/connect.txt

@@ -1,21 +1,29 @@
 :noprevnext:
 
-=================
-Deployment Access
-=================
+.. _k8s-connect-resources:
+
+=========================
+Access Database Resources
+=========================
 
 .. default-domain:: mongodb
 
-The following pages describe how to connect to your MongoDB
-resource deployed by |k8s|:
+The following pages describe how to connect to a MongoDB
+database resource that is deployed to |k8s|:
+
+:ref:`connect-from-inside-k8s`
+  Connect to a MongoDB database resource from inside
+  of the |k8s| cluster.
 
-.. include:: /includes/toc/dfn-list-connect.rst
+:ref:`connect-from-outside-k8s`
+  Connect to a MongoDB database resource from outside
+  of the |k8s| cluster.
 
-.. include:: /includes/toc/connect.rst
 
 .. class:: hidden
 
    .. toctree::
       :titlesonly:
 
       /tutorial/connect-from-inside-k8s
+      /tutorial/connect-from-outside-k8s

source/deploy.txt

@@ -1,10 +1,10 @@
 :noprevnext:
 
-.. _deploy-resources:
+.. _k8s-deploy-mdb-resources:
 
-================
-Deploy Resources
-================
+==================================
+Deploy a MongoDB Database Resource
+==================================
 
 .. default-domain:: mongodb
 
@@ -14,17 +14,20 @@ Deploy Resources
    :depth: 1
    :class: singlecol
 
-.. include:: /includes/toc/dfn-list-deploy.rst
+:ref:`deploy-standalone`
+  Use |k8s-op-short| to deploy a new standalone MongoDB instance.
 
-.. include:: /includes/toc/deploy.rst
+:ref:`deploy-replica-set`
+  Use |k8s-op-short| to deploy a replica set.
+
+:ref:`deploy-sharded-cluster`
+  Use |k8s-op-short| to deploy a sharded cluster.
 
 .. class:: hidden
 
    .. toctree::
       :titlesonly:
 
-      /tutorial/deploy-om-container
       /tutorial/deploy-standalone
       /tutorial/deploy-replica-set
       /tutorial/deploy-sharded-cluster
-      /tutorial/edit-deployment