TOC and metadata updates for semantic howto

Author: HeidiSteen

articles/search/TOC.yml

@@ -412,7 +412,7 @@
       href: semantic-how-to-enable-disable.md      
     - name: Configure semantic ranking
       href: semantic-how-to-configure.md
-    - name: Invoke semantic ranking
+    - name: Add semantic ranking to queries
       href: semantic-how-to-query-request.md
     - name: Configure BM25 ranking
       href: index-ranking-similarity.md

articles/search/search-api-migration.md

@@ -89,9 +89,9 @@ If you're upgrading from the previous version, the next section has the steps.
 
 ## Upgrade from 2023-07-01-preview
 
-Do not use this API version.
+Do not use this API version. It implements a vector query syntax that's incompatible with any newer API version.
 
-`2023-07-01-preview` is now deprecated, so you shouldn't base new code on this version, nor should you upgrade *to* this version under any circumstances. This section explains the migration path from `2023-07-01-preview` to any newer API version. There are multiple breaking changes in vector query syntax from `2023-07-01-preview` to any newer version.
+`2023-07-01-preview` is now deprecated, so you shouldn't base new code on this version, nor should you upgrade *to* this version under any circumstances. This section explains the migration path from `2023-07-01-preview` to any newer API version.
 
 ### Portal upgrade for vector indexes
 

articles/search/semantic-how-to-query-request.md

@@ -1,5 +1,5 @@
 ---
-title: Query with semantic ranking
+title: Add semantic ranking
 titleSuffix: Azure AI Search
 description: Set a semantic query type to attach the deep learning models of semantic ranking.
 
@@ -13,7 +13,7 @@ ms.topic: how-to
 ms.date: 06/13/2024
 ---
 
-# Create a semantic query in Azure AI Search
+# Add semantic ranking to queries in Azure AI Search
 
 This article explains how to invoke the semantic ranker on queries. You can apply semantic ranking to text queries, hybrid queries, and vector queries if your search documents contain string fields and the [vector query has a text representation](vector-search-how-to-query.md#query-with-integrated-vectorization-preview).