Fixing titles and headings

Author: HeidiSteen

articles/search/index-add-scoring-profiles.md

@@ -11,16 +11,18 @@ ms.topic: how-to
 ms.date: 10/14/2022
 ---
 
-# Add scoring profiles to boost search scores in Azure Cognitive Search
+# Add scoring profiles to boost search scores
 
-In this article, you can learn how to create a scoring profile for boosting search scores based on criteria that you provide. Criteria can be weighting a field, for example if a match found in a "tags" field is more relevant than a match found in "descriptions". Criteria can also be a function, such as the `distance` function that favors results that are within a specified distance of the current location. 
+In this article, you'll learn how to define a scoring profile for boosting search scores based on criteria.
+
+Criteria can be a weighted field, such as when a match found in a "tags" field is more relevant than a match found in "descriptions". Criteria can also be a function, such as the `distance` function that favors results that are within a specified distance of the current location.
 
 Scoring profiles are defined in a search index and invoked on query requests. You can create multiple profiles and then modify query logic to choose which one is used.
 
 > [!NOTE]
-> Unfamiliar with relevance concepts? The following video segment fast-forwards to how scoring profiles work in Azure Cognitive Search, but the video also covers basic concepts. You might also want to review [Relevance and scoring in Azure Cognitive Search](index-similarity-and-scoring.md) for more background.
+> Unfamiliar with relevance concepts? The following video segment fast-forwards to how scoring profiles work in Azure Cognitive Search. You can also visit [Relevance and scoring in Azure Cognitive Search](index-similarity-and-scoring.md) for more background.
 >
-> [!VIDEO https://www.youtube.com/embed/Y_X6USgvB1g?version=3&start=463&end=970]
+> > [!VIDEO https://www.youtube.com/embed/Y_X6USgvB1g?version=3&start=463&end=970]
 >
 
 ## Scoring profile definition
@@ -54,7 +56,7 @@ The following definition shows a simple profile named 'geo'. This example boosts
 ]
 ```  
 
-To use this scoring profile, your query is formulated to specify scoringProfile parameter in the request.
+Parameters are specified on invocation. To use this scoring profile, your query is formulated to specify scoringProfile parameter in the request.
 
 ```http
 POST /indexes/hotels/docs&api-version=2020-06-30

articles/search/index-ranking-similarity.md

@@ -1,5 +1,5 @@
 ---
-title: Configure scoring algorithm
+title: Configure relevance scoring
 titleSuffix: Azure Cognitive Search
 description: Enable Okapi BM25 ranking to upgrade the search ranking and relevance behavior on older Azure Search services.
 
@@ -10,7 +10,7 @@ ms.topic: how-to
 ms.date: 10/14/2022
 ---
 
-# Configure the similarity scoring algorithm in Azure Cognitive Search
+# Configure relevance scoring
 
 In this article, you'll learn how to configure the similarity scoring algorithm used by Azure Cognitive Search. The BM25 scoring model has defaults for weighting term frequency and document length. You can customize these properties if the defaults aren't suited to your content.