Prod notes: added sizings and updated examples (#520)

* Prod notes: added sizings and updated examples

* Initial comments from Raj

* Include copy review comments from Melissa

* Address final copy review comments, ready for tech review

* Address tech review, part1

* Final minor changes for tech review

* Final copy and tech review

Author: JuliaMongo

conf.py

@@ -59,6 +59,7 @@
 source_constants = {
     'version': version,
     'k8s-op-short': 'Kubernetes Operator',
+    'k8s-api-version': 'v1.20',
     'aagent': 'MongoDB Agent or legacy Automation Agent',
     'aagents': 'MongoDB Agents or legacy Automation Agents',
     'mdbagent': 'MongoDB Agent',

snooty.toml

@@ -4,6 +4,7 @@ name = "k8s-operator"
 aagent = "MongoDB Agent or legacy Automation Agent"
 aagents = "MongoDB Agents or legacy Automation Agents"
 k8s-op-short = "Kubernetes Operator"
+k8s-api-version = "v1.20"
 bndl-version = "4.2.2"
 bndl-version-val = "``4.2.11-ent``"
 appdb-init-version = "1.0.6"

source/includes/options-k8s-shared.yaml

@@ -240,7 +240,7 @@ description: |
   |k8s-node| to host {{component}}.
 
   This value maps to the
-  :k8sdocs:`limits field </reference/generated/kubernetes-api/v1.10/#resourcerequirements-v1-core>`
+  :k8sdocs:`limits field </reference/generated/kubernetes-api/{+k8s-api-version+}/#resourcerequirements-v1-core>`
   for CPU for the created pod.
 
 
@@ -261,7 +261,7 @@ description: |
   {{cpuLimit}}.
 
   This value maps to the
-  :k8sdocs:`requests field </reference/generated/kubernetes-api/v1.11/#resourcerequirements-v1-core>`
+  :k8sdocs:`requests field </reference/generated/kubernetes-api/{+k8s-api-version+}/#resourcerequirements-v1-core>`
   for CPU for the created pod.
 
   The requested value must be less than or equal to {{cpuLimit}}.
@@ -298,7 +298,7 @@ description: |
      this value to ``4Gi``.
 
   This value maps to the
-  :k8sdocs:`limits field </reference/generated/kubernetes-api/v1.10/#resourcerequirements-v1-core>`
+  :k8sdocs:`limits field </reference/generated/kubernetes-api/{+k8s-api-version+}/#resourcerequirements-v1-core>`
   for memory for the created pod.
 
   {{memoryWarning}}
@@ -321,7 +321,7 @@ description: |
   {{memoryLimit}}.
 
   This value maps to the
-  :k8sdocs:`requests field </reference/generated/kubernetes-api/v1.10/#resourcerequirements-v1-core>`
+  :k8sdocs:`requests field </reference/generated/kubernetes-api/{+k8s-api-version+}/#resourcerequirements-v1-core>`
   for memory for the created pod.
 
   The requested value must be less than or equal to {{memoryLimit}}.
@@ -1220,7 +1220,7 @@ description: |
   {{component}}.
 
   To review which fields you can add to {{podTemplate_metadata}}, see
-  the :k8sdocs:`Kubernetes documentation </reference/generated/kubernetes-api/v1.11/#objectmeta-v1-meta>`.
+  the :k8sdocs:`Kubernetes documentation </reference/generated/kubernetes-api/{+k8s-api-version+}/#objectmeta-v1-meta>`.
 
 ---
 program: _shared
@@ -1234,7 +1234,7 @@ description: |
   {{component}}.
 
   To review which fields you can add to {{podTemplate_spec}}, see the
-  :k8sdocs:`Kubernetes documentation </reference/generated/kubernetes-api/v1.11/#podspec-v1-core>`.
+  :k8sdocs:`Kubernetes PodSpec v1 core API </reference/generated/kubernetes-api/{+k8s-api-version+}/#podspec-v1-core>`.
 
   .. note::
 

source/index.txt

@@ -56,5 +56,6 @@ optimal performance.
       /reference
       /specification
       Release Notes </release-notes>
+      Production Notes </reference/production-notes>
       Known Issues </reference/known-issues>
       MongoDB Community Kubernetes Operator <https://github.com/mongodb/mongodb-kubernetes-operator>