OLS-1622: minor edits

Author: rh-tokeefe

Diff for: modules/ols-activating-token-quota-limits.adoc

@@ -17,18 +17,20 @@ Modify the `OLSConfigMap` file to activate token quota limits for the {ols-long}
 
 .Procedure
 
-. Open the `OLSConfigMap` file by running the following command:
+. Open the {ols-long} `ConfigMap` file by running the following command:
 +
 [source,terminal]
 ----
-$ oc edit configmap <configmap_name>
+$ oc edit configmap <configmap_filename>
 ----
 
-. Modify the `OLSConfigMap` file.
+. Modify the `ConfigMap` file to include token quota limit information.
 +
-.Example `ServiceMeshControlPlane` cert-manager configuration
+.Example {ols-long} `ConfigMap` file
 [source,yaml]
 ----
+kind: ConfigMap
+apiVersion: v1
 quota_handlers:
   storage:
     host: <IP_address> <1>
@@ -38,14 +40,14 @@ quota_handlers:
     password_path: <file_containing_database_password>
     ssl_mode: disable
   limiters:
-    - name: user_monthly_limits <2>
+    - name: user_monthly_limits 
       type: user_limiter
-      initial_quota: 100000
+      initial_quota: 100000 <2>
       quota_increase: 10
       period: 30 days
-    - name: cluster_monthly_limits <3>
+    - name: cluster_monthly_limits 
       type: cluster_limiter
-      quota_increase: 1000000
+      quota_increase: 1000000 <3>
       period: 30 days
   scheduler:
     period: 300 <4>
@@ -55,10 +57,9 @@ quota_handlers:
 <3> Increases the token quota limit for the cluster by 100,000 over a period of 30 days.
 <4> Defines the number of seconds that the scheduler waits and then checks if the period interval is over. When the period interval is over, the scheduler stores the timestamp and resets or increases the quota limit.
 
-. Apply the `OLSConfigMap` file so that the token limit quota takes effect by running the following command:
+. Apply the `ConfigMap` file so that the token limit quota takes effect by running the following command:
 +
 [source,terminal]
 ----
 $ oc apply -f <configmap_name>
-----
-
+----

Diff for: modules/ols-tokens-and-token-quota-limits.adoc

@@ -5,8 +5,8 @@
 [id="ols-tokens-and-token-quota-limits_{context}"]
 = Tokens and token quota limits
 
-Tokens are small chunks of text, which can be as short as one character or as long as one word. Tokens are the units of measurement used to quantify the amount of text that the {ols-long} Service sends to, or receives from, a large language model (LLM) - every interaction with the LLM is counted in tokens.
+Tokens are small chunks of text, which can be as small as one character or as large as one word. Tokens are the units of measurement used to quantify the amount of text that the {ols-long} Service sends to, or receives from, a large language model (LLM). Every interaction with the Service and the LLM is counted in tokens.
 
-Token quota limits define the number of tokens that can be used in a certain timeframe. Implementing token quota limits helps control costs, encourages more efficient use of queries, and helps regulate system demands. In multi-user configurations, token quota limits can provide equal access to all users ensuring everyone has an opportunity to submit queries. 
+Token quota limits define the number of tokens that can be used in a certain timeframe. Implementing token quota limits helps control costs, encourage more efficient use of queries, and regulate system demands. In a multi-user configuration, token quota limits help provide equal access to all users ensuring everyone has an opportunity to submit queries. 
 
-Token quota limits can be defined for an {ocp-short-name} cluster or for an individual user account. 
+You can define token quota limits for {ocp-short-name} clusters or {ocp-short-name} user accounts.