edited per erik

Author: mburke5678

modules/efk-logging-deploy-subscription.adoc

@@ -108,29 +108,42 @@ You might need to refresh the page to load the data.
 apiVersion: "logging.openshift.io/v1alpha1"
 kind: "ClusterLogging"
 metadata:
-  name: "instance"
+  name: "instance"  <1>
   namespace: "openshift-logging"
 spec:
-  managementState: "Managed"
+  managementState: "Managed"  <2>
   logStore:
-    type: "elasticsearch"
+    type: "elasticsearch"  <3>
     elasticsearch:
       nodeCount: 3
       storage: {}
       redundancyPolicy: "SingleRedundancy"
   visualization:
-    type: "kibana"
+    type: "kibana"  <4>
     kibana:
       replicas: 1
   curation:
-    type: "curator"
+    type: "curator"  <5>
     curator:
       schedule: "30 3 * * *"
   collection:
     logs:
-      type: "fluentd"
+      type: "fluentd"  <6>
       fluentd: {}
 ----
+<1> The name of the Cluster Logging Custom Resource.
+<2> The cluster logging management state. In most cases, if you change the default cluster logging defaults, you will need to set this to `Unmanaged`. 
+However, an unmanaged deployment does not receive updates until the cluster logging is placed back into a managed state. See *Changing cluster logging management state*.
+<3> Settings for configuring Elasticsearch. Using the CR, you can configure shard replication policy and persistent storage. See *Configuring Elasticsearch*.
+<4> Settings for configuring Kibana. Using the CR, you can scale Kibana for redundancy and configure the CPU and memory for your Kibana nodes. See *Configuring Kibana*.
+<5> Settings for configuring Curator. Using the CR, you can set the Curator schedule. See *Configuring Curator*.
+<6> Settings for configuring Fluentd. Using the CR, you can configure Fluentd CPU and memory limits. See *Configuring Fluentd*.
++
+[NOTE]
+====
+The default cluster logging configuration should support a wide array of environments. Review the topics on tuning and 
+configuring the cluster logging components for information on modifications you can make to your cluster logging cluster.
+==== 
 
 .. Click *Create*. This creates the Cluster Logging Custom Resource, which you
 can edit to make changes to your cluster logging cluster.