lots of clean ups

Author: epugh

_search-plugins/ubi/index.md

@@ -22,33 +22,33 @@ This differs from many systems that infer the linking of search to events throug
 > “how our users are using our product, whether search results were useful for them and whether they clicked on top-n results we gave and all related stuff” - Data Scientist
 
 UBI includes the following elements:
-* [ubi.js](https://github.com/opensearch-project/user-behavior-insights/tree/main/ubi-javascript-collector/ubi.js): a clientside JavaScript library for capturing searches and events.
+* [ubi.js](https://github.com/opensearch-project/user-behavior-insights/tree/main/ubi-javascript-collector/ubi.js): a (optional!) clientside JavaScript library for capturing searches and events.
 * A machine-readable [schema](https://github.com/o19s/ubi) that faciliates interoperability of the UBI specification.
 * An (optional!) OpenSearch [plugin](https://github.com/opensearch-project/user-behavior-insights) that streamlines the recording of query data.
 
-Advanced features in OpenSearch, such as the Search Quality Evaluation Framework, and the Hybrid Search Optimizer all build on the UBI specification.
+Advanced features in OpenSearch, such as the [Search Relevance Workbench]({{site.url}}{{site.baseurl}}/search-plugins/search-relevance/using-search-relevance-workbench/) and the [Hybrid Search Optimizer]({{site.url}}{{site.baseurl}}/search-plugins/search-relevance/optimize-hybrid-search/) build on the data collected using the UBI specification.
 
 <!-- vale off -->
 
 <table>
     <tr style="vertical-align: top;">
         <td>
             <h2>Tutorials</h2>
-            <ul>
-                <li><a href="#">Learn to use <code>ubi.js</code></a></li>
-                <li><a href="https://github.com/opensearch-project/user-behavior-insights">How to install and use the UBI plugin</a><b>do we keep this</b></li>
+            <ul>                
                 <li><a href="#">Using OpenSearch Ingestion from AWS with UBI</a></li>
-                <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/ubi-dashboard-tutorial/">Learn to create custom dashboards with UBI data.</a></li>                
+                <li><a href="#">Learn to use <code>ubi.js</code></a></li>                
+                <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/ubi-dashboard-tutorial/">Learn to create custom dashboards</a>  for UBI data.</li>                
             </ul>
         </td>
         <td>
             <h2>How To Guides</h2>
             <ul>                
+                <li><a href="https://github.com/opensearch-project/user-behavior-insights">How to use the UBI plugin</a> in OpenSearch</li>.
                 <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/dsl-queries/">How to write queries for UBI data in OpenSearch query DSL.</a></li>
                 <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/sql-queries/">How to write analytic queries for UBI data in SQL.</a></li>
                 <li><a href="https://github.com/o19s/chorus-opensearch-edition/blob/main/katas/006_protecting_sensitive_information.md">How to protect sensistive information when using UBI.</a></li>
                 <li><a href="https://github.com/o19s/chorus-opensearch-edition/blob/main/katas/007_configure_AB_with_TDI.md">Configuring an AB test with Team Draft Interleaving</a></li>           
-           <li><a href="https://github.com/opensearch-project/user-behavior-insights">How to install and use the UBI plugin</a><b>do we keep this</b></li>     
+                <li><a href="https://github.com/opensearch-project/user-behavior-insights">How to install and use the UBI plugin</a><b>do we keep this</b></li>     
             </ul>
         </td>
     </tr>
@@ -58,16 +58,18 @@ Advanced features in OpenSearch, such as the Search Quality Evaluation Framework
             <ul>
                 <li><a href="https://UBISearch.dev">Why UBI?</a></li>
                 <li><a href="https://github.com/opensearch-project/user-behavior-insights">How to install and use the UBI plugin</a><b>do we keep this</b></li>
-                <li>Learn more about this community standard via <a href="https://UBISearch.dev">UBISearch.dev</a>.</li>
+                <li>Learn more about this community standard via <a href="https://UBISearch.dev">UBISearch.dev</a> community clearinghouse.</li>
                 <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/ubi-javascript-collector/">UBI JavaScript Collector</a>, a client-side JavaScript library for capturing events.</li>
+                <li>Learn more about improving relevance.  Watch <a href="https://youtu.be/0chun264PRQ">Leveraging UBI to enhance Search Relevance</a> talk.</li>
+                <li>Learn how to build on UBI data.  Watch <a href="https://www.youtube.com/watch?v=xi261oUamXc">You’ve Deployed User Behavior Insights. Now What?</a>.
             </ul>
         </td>
         <td>
             <h2>Reference</h2>
             <ul>
-                <li><a href="https://o19s.github.io/ubi/docs/html/1.2.0/query.request.schema.html">Query Tracking Specification</a></li>
-                <li><a href="https://o19s.github.io/ubi/docs/html/1.2.0/event.schema.html">Event Tracking Specification</a></li>                
-                <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/schemas/">UBI Plugin Schema</a><b>DO WE KEEP THIS</b></li>
+                <li><a href="https://o19s.github.io/ubi/docs/html/1.3.0/query.request.schema.html">Query Tracking Specification</a></li>
+                <li><a href="https://o19s.github.io/ubi/docs/html/1.3.0/event.schema.html">Event Tracking Specification</a></li>                
+                <li><a href="{{site.url}}{{site.baseurl}}/search-plugins/ubi/schemas/">UBI Plugin Schema</a></li>
             </ul>
         </td>
     </tr>

_search-plugins/ubi/sql-queries.md

@@ -10,16 +10,16 @@ nav_order: 20
 
 You can run sample User Behavior Insights (UBI) SQL queries in the OpenSearch Dashboards [Query Workbench]({{site.url}}{{site.baseurl}}/dashboards/query-workbench/).
 
-To query a demo workbench with synthetic data, see 
+To access a demo query workbench with synthetic data, see 
 [http://chorus-opensearch-edition.dev.o19s.com:5601/app/opensearch-query-workbench](http://chorus-opensearch-edition.dev.o19s.com:5601/app/opensearch-query-workbench).
 
 ## Queries with zero results
 
-Queries can be executed on events on either the server (`ubi_queries`) or client (`ubi_events`) side.
+Queries can be executed on events on either the queries index (`ubi_queries`) or events index (`ubi_events`).
 
 ### Server-side queries
 
-The UBI-activated search server logs the queries and their results, so in order to find all queries with *no* results, search for empty `query_response_hit_ids`:
+A UBI-enabled search server logs the queries and their results as they are made, so in order to find all queries with *no* results, search for empty `query_response_hit_ids`:
 
 ```sql
 select

_search-plugins/ubi/ubi-dashboard-tutorial.md

@@ -11,6 +11,8 @@ nav_order: 25
 
 Whether you've been collecting user events and queries for a while or [you've uploaded some sample events](https://github.com/o19s/chorus-OpenSearch-edition/blob/main/katas/003_import_preexisting_event_data.md), you're now ready to visualize the data collected through User Behavior Insights (UBI) in a dashboard in OpenSearch.
 
+> This tutorial is a nice way to learn how to make custom Dashboards.
+
 To quickly view a dashboard without completing the full tutorial, do the following:
 1. Download and save the [sample UBI dashboard]({{site.url}}{{site.baseurl}}/assets/examples/ubi-dashboard.ndjson).
 1. On the top menu, go to **Management > Dashboard Management**.
@@ -90,5 +92,3 @@ Now you can further filter the displayed data. For example, you can see how the
 
 You can filter event messages containing the word `*laptop*` by adding wildcards, as shown in the following image.
 ![Laptop]({{site.url}}{{site.baseurl}}/images/ubi/laptop.png "Laptop").
- 
-