Addressing review comments and nitpicks

Author: Srivaralakshmi

modules/sbo-categories-of-exposable-binding-data.adoc

@@ -41,9 +41,9 @@ metadata:
 
 
 == Exposing an entire config map or secret that is referenced from a resource
-The following examples show how to expose an entire secret as annotations:
+The following examples show how to expose an entire secret using annotations:
 
-.Example: Exposing an entire secret as annotations
+.Example: Exposing an entire secret through annotations
 [source,yaml]
 ----
 apiVersion: postgres-operator.crunchydata.com/v1beta1
@@ -67,9 +67,9 @@ data:
   user: "Z3Vlc3Q="
 ----
 
-The following example shows how to expose an entire config map as OLM descriptors:
+The following example shows how to expose an entire config map through OLM descriptors:
 
-.Example: Exposing an entire config map as OLM descriptors
+.Example: Exposing an entire config map through OLM descriptors
 [source,yaml]
 ----
 - path: data.dbConfiguration
@@ -84,9 +84,9 @@ If you intend to project all the values from a `ConfigMap` service resource, you
 
 
 == Exposing a specific entry from a config map or secret that is referenced from a resource
-The following examples show how to expose a specific entry from a config map as annotations:
+The following examples show how to expose a specific entry from a config map through annotations:
 
-.Example: Exposing an entry from a config map as annotations
+.Example: Exposing an entry from a config map through annotations
 [source,yaml]
 ----
 apiVersion: postgres-operator.crunchydata.com/v1beta1
@@ -111,9 +111,9 @@ data:
   user: "hippo"
 ----
 
-The following example shows how to expose a specific entry from a config map as OLM descriptors:
+The following example shows how to expose a specific entry from a config map through OLM descriptors:
 
-.Example: Exposing an entry from a config map as OLM descriptors
+.Example: Exposing an entry from a config map through OLM descriptors
 [source,yaml]
 ----
 - path: data.dbConfiguration
@@ -129,9 +129,9 @@ This example uses the `path` attribute with an `X-Descriptors` update for `servi
 
 
 == Exposing a resource definition value
-The following example shows how to expose a resource definition value as annotations:
+The following example shows how to expose a resource definition value through annotations:
 
-.Example: Exposing a resource definition value as annotations
+.Example: Exposing a resource definition value through annotations
 [source,yaml]
 ----
 apiVersion: postgres-operator.crunchydata.com/v1beta1
@@ -144,9 +144,9 @@ metadata:
     ...
 ----
 
-The following example shows how to expose a resource definition value as OLM descriptors:
+The following example shows how to expose a resource definition value through OLM descriptors:
 
-.Example: Exposing a resource definition value as OLM descriptors
+.Example: Exposing a resource definition value through OLM descriptors
 [source,yaml]
 ----
 - path: data.connectionURL
@@ -160,9 +160,9 @@ If required values are available as attributes of backing service resources, ann
 
 
 == Exposing entries of a collection with the key and value from each entry
-Following is the example for exposing the entries of a collection with the key and value from each entry as annotations:
+Following is the example for exposing the entries of a collection with the key and value from each entry through annotations:
 
-.Example: Exposing the entries of a collection as annotations
+.Example: Exposing the entries of a collection through annotations
 [source,yaml]
 ----
 apiVersion: postgres-operator.crunchydata.com/v1beta1
@@ -193,9 +193,9 @@ The following example shows how the previous entries of a collection in annotati
 /bindings/<binding-name>/uri_404 => black-hole.example.com
 ----
 
-Following is the example for exposing the entries of a collection with the key and value from each entry as OLM descriptors:
+Following is the example for exposing the entries of a collection with the key and value from each entry through OLM descriptors:
 
-.Example: Exposing the entries of a collection as OLM descriptors
+.Example: Exposing the entries of a collection through OLM descriptors
 [source,yaml]
 ----
 - path: bootstrap
@@ -223,9 +223,9 @@ The previous example helps you to project all those values with keys such as `pr
 
 
 == Exposing items of a collection with one key per item
-Following is the example for exposing the items of a collection with one key per item as annotations:
+Following is the example for exposing the items of a collection with one key per item through annotations:
 
-.Example: Exposing the items of a collection as annotations
+.Example: Exposing the items of a collection through annotations
 [source,yaml]
 ----
 apiVersion: postgres-operator.crunchydata.com/v1beta1
@@ -251,9 +251,9 @@ The following example shows how the previous items of a collection in annotation
 /bindings/<binding-name>/tags_2 => power
 ----
 
-Following is the example for exposing the items of a collection with one key per item as OLM descriptors:
+Following is the example for exposing the items of a collection with one key per item through OLM descriptors:
 
-.Example: Exposing the items of a collection as OLM descriptors
+.Example: Exposing the items of a collection through OLM descriptors
 [source,yaml]
 ----
 - path: spec.tags
@@ -274,9 +274,9 @@ spec:
 
 
 == Exposing values of collection entries with one key per entry value
-Following is the example for exposing the values of collection entries with one key per entry value as annotations:
+Following is the example for exposing the values of collection entries with one key per entry value through annotations:
 
-.Example: Exposing the values of collection entries as annotations
+.Example: Exposing the values of collection entries through annotations
 [source,yaml]
 ----
 apiVersion: postgres-operator.crunchydata.com/v1beta1
@@ -305,9 +305,9 @@ The following example shows how the previous values of a collection in annotatio
 /bindings/<binding-name>/url_2 => black-hole.example.com
 ----
 
-Following is the example for exposing the values of collection entries with one key per entry value as OLM descriptors:
+Following is the example for exposing the values of collection entries with one key per entry value through OLM descriptors:
 
-.Example: Exposing the values of collection entries as OLM descriptors
+.Example: Exposing the values of collection entries through OLM descriptors
 [source,yaml]
 ----
 - path: bootstrap

modules/sbo-methods-of-exposing-binding-data.adoc

@@ -16,8 +16,8 @@ The service you intend to connect to is compliant with the Service Binding speci
 You must expose the binding data from the backing service. Depending on your workload requirements and environment, you can choose any of the following methods to expose the binding data:
 +
 ** Direct secret reference
-** Generation of an intermediate secret through custom resource definition (CRD) or CR annotations
-** Generation of an intermediate secret through Operator Lifecycle Manager (OLM) descriptors
+** Declaring binding data through custom resource definition (CRD) or CR annotations
+** Declaring binding data through Operator Lifecycle Manager (OLM) descriptors
 ** Detection of binding data through owned resources
 
 == Provisioned service