Merge pull request #279105 from HeidiSteen/heidist-june24

[azure search] TOC edits

Author: Stacyrch140

articles/search/.openpublishing.redirection.search.json

@@ -1,5 +1,10 @@
 {
     "redirections": [
+        {
+            "source_path_from_root": "/articles/search/search-security-trimming-for-azure-search-with-aad.md",
+            "redirect_url": "/previous-versions/azure/search/search-security-trimming-for-azure-search-with-aad",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/search/search-synonyms-tutorial-sdk.md",
             "redirect_url": "https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/search/Azure.Search.Documents/samples/Sample02_Service.md#create-a-synonym-map",

articles/search/TOC.yml

@@ -167,11 +167,11 @@
     items:
     - name: Semantic ranking
       href: semantic-search-overview.md
-    - name: Keyword queries (BM25 ranking)
+    - name: BM25 ranking
       href: index-similarity-and-scoring.md
-    - name: Vector queries
+    - name: Vector ranking
       href: vector-search-ranking.md
-    - name: Hybrid queries (RRF)
+    - name: Hybrid ranking (RRF)
       href: hybrid-search-ranking.md
   - name: Security
     items:
@@ -354,8 +354,6 @@
     items:
     - name: Full text query
       href: search-query-create.md
-    - name: Semantic query
-      href: semantic-how-to-query-request.md
     - name: Typeahead query
       href: search-add-autocomplete-suggestions.md
     - name: Query examples (simple syntax)
@@ -398,16 +396,6 @@
         href: search-pagination-page-layout.md
       - name: Return a semantic answer
         href: semantic-answers.md
-    - name: Relevance
-      items:
-      - name: Enable or disable semantic ranking
-        href: semantic-how-to-enable-disable.md      
-      - name: Configure semantic ranking
-        href: semantic-how-to-configure.md
-      - name: Configure BM25 ranking
-        href: index-ranking-similarity.md
-      - name: Add a scoring profile
-        href: index-add-scoring-profiles.md
     - name: Advanced queries
       items:
       - name: Use full Lucene (examples)
@@ -418,6 +406,18 @@
         href: search-query-fuzzy.md
   - name: Hybrid search
     href: hybrid-search-how-to-query.md
+  - name: Ranking and relevance
+    items:
+    - name: Enable or disable semantic ranking
+      href: semantic-how-to-enable-disable.md      
+    - name: Configure semantic ranking
+      href: semantic-how-to-configure.md
+    - name: Configure BM25 ranking
+      href: index-ranking-similarity.md
+    - name: Add semantic ranking to queries
+      href: semantic-how-to-query-request.md
+    - name: Add a scoring profile
+      href: index-add-scoring-profiles.md
   - name: Security
     items:
     - name: Enable role-based access control
@@ -465,11 +465,7 @@
       - name: Find encrypted objects
         href: search-security-get-encryption-keys.md
     - name: Document-level security
-      items:
-      - name: Security filters
-        href: search-security-trimming-for-azure-search.md
-      - name: Security filters with Microsoft Entra ID
-        href: search-security-trimming-for-azure-search-with-aad.md
+      href: search-security-trimming-for-azure-search.md
   - name: Development
     items:
     - name: API versions

articles/search/search-api-migration.md

@@ -1,7 +1,7 @@
 ---
 title: Upgrade REST API versions
 titleSuffix: Azure AI Search
-description: Review differences in API versions and learn the steps for migrating code to the newer versions.
+description: Review differences in API versions and learn about the REST API lifecycle and the steps for migrating code to the newer versions.
 
 manager: nitinme
 author: bevloh
@@ -11,7 +11,7 @@ ms.custom:
   - ignite-2023
   - build-2024
 ms.topic: conceptual
-ms.date: 06/03/2024
+ms.date: 06/24/2024
 ---
 
 # Upgrade to the latest REST API in Azure AI Search
@@ -26,7 +26,7 @@ Upgrade instructions focus on code changes that get you through breaking changes
 
 We recommend upgrading API versions in succession, working through each version until you get to the newest one.
 
-`2023-07-01-preview` was the first REST API for vector support. It's now deprecated and you should migrate to either stable or newer preview REST APIs immediately.
+`2023-07-01-preview` was the first REST API for vector support. *Do not use this API version*. It's now deprecated and you should migrate to either stable or newer preview REST APIs immediately.
 
 > [!NOTE]
 > REST API reference docs are now versioned. For version-specific content, open a reference page and then use the selector located to the right, above the table of contents, to pick your version.
@@ -89,7 +89,9 @@ If you're upgrading from the previous version, the next section has the steps.
 
 ## Upgrade from 2023-07-01-preview
 
-`2023-07-01-preview` is now deprecated, so you shouldn't 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 from `2023-07-01-preview` to any newer 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.
 
 ### Portal upgrade for vector indexes
 

articles/search/search-security-trimming-for-azure-search-with-aad.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).