Skip to content

Commit 1a34609

Browse files
author
Luis Cabrera
committed
Changed date to July 15 to provide buffer
1 parent 18db44e commit 1a34609

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

articles/search/index-ranking-similarity.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@ ms.date: 03/13/2020
1414
# Ranking algorithm in Azure Cognitive Search
1515

1616
> [!IMPORTANT]
17-
> Starting May 1, 2020, newly created search services will use the BM25 ranking function, which has proven in most cases to provide search rankings that align better with user expectations than the current default ranking. Beyond superior ranking, BM25 also enables configuration options for tuning results based on factors such as document size.
17+
> Starting July 15, 2020, newly created search services will use the BM25 ranking function, which has proven in most cases to provide search rankings that align better with user expectations than the current default ranking. Beyond superior ranking, BM25 also enables configuration options for tuning results based on factors such as document size.
1818
>
1919
> With this change, you will most likely see slight changes in the ordering of your search results. For those that want to test the impact of this change, we have made available in the 2019-05-06-Preview API an ability to enable BM25 scoring on new indexes.
2020
21-
This article describes how you can update a service created before May 1, 2020 to to use the new BM25 ranking algorithm.
21+
This article describes how you can update a service created before July 15, 2020 to to use the new BM25 ranking algorithm.
2222

2323
Azure Cognitive Search will be using the official Lucene implementation of the Okapi BM25 algorithm, *BM25Similarity*, which will replace the previously used *ClassicSimilarity* implementation. Like the older ClassicSimilarity algorithm, BM25Similarity is a TF-IDF-like retrieval function which uses the term frequency (TF) and the inverse document frequency (IDF) as variables to calculate relevance scores for each document-query pair, which is then used for ranking. While conceptually similar to the older Classic Similarity algorithm, BM25 takes its root in probabilistic information retrieval to improve upon it. BM25 also offers advanced customization options, such as allowing the user to decide how the relevance score scales with the term frequency of matched terms.
2424

@@ -53,9 +53,9 @@ PUT https://[search service name].search.windows.net/indexes/[index name]?api-ve
5353
}
5454
```
5555

56-
For services created before May 1, 2020: If the similarity is omitted or set to null, the index will use the old classic similarity algorithm.
56+
For services created before July 15, 2020: If the similarity is omitted or set to null, the index will use the old classic similarity algorithm.
5757

58-
For services created after May 1, 2020: If the similarity is omitted or set to null, the index will use the new BM25 similarity algorithm.
58+
For services created after July 15, 2020: If the similarity is omitted or set to null, the index will use the new BM25 similarity algorithm.
5959

6060
You can also explicitly set the similarity value to be one of the following two values: *"#Microsoft.Azure.Search.ClassicSimilarity"* or *"#Microsoft.Azure.Search.BM25Similarity"*.
6161

0 commit comments

Comments
 (0)