Skip to content

Commit dba55b5

Browse files
author
Luis Cabrera
authored
Adding a bit more detail on hit highlighting
1 parent 9a1f36c commit dba55b5

File tree

1 file changed

+16
-5
lines changed

1 file changed

+16
-5
lines changed

articles/search/search-pagination-page-layout.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -104,10 +104,21 @@ POST /indexes/hotels-sample-index/docs/search?api-version=2019-05-06
104104
}
105105
```
106106

107-
> [!IMPORTANT]
108-
> Services created after July 15, 2020 will provide a different highlighting experience. Services created before that date will not change in their highlighting behavior. With this change, only phrases that match the full phrase query will be returned. Also, it will be possible to specify the fragment size returned for the highlight.
109-
>
110-
> When you are writing client code that implements hit highlighting, be aware of this change. Note that this will not impact you unless you create a completely new search service.
107+
### New behavior (starting July 15, 2020)
108+
109+
Services created after July 15, 2020 will provide a different highlighting experience. Services created before that date will not change in their highlighting behavior.
110+
111+
With the new behavior:
112+
* Only phrases that match the full phrase query will be returned. The query "super bowl" will return hightlights like this:
113+
114+
```html
115+
'<em>super bowl</em> is super awesome with a bowl of chips'
116+
```
117+
Note that the term *bowl of chips* does not have any highlighting since it does not match the full phrase.
118+
119+
* It will be possible to specify the fragment size returned for the highlight.
120+
121+
When you are writing client code that implements hit highlighting, be aware of this change. Note that this will not impact you unless you create a completely new search service.
111122

112123
## Next steps
113124

@@ -116,4 +127,4 @@ To quickly generate a search page for your client, consider these options:
116127
+ [Application Generator](search-create-app-portal.md), in the portal, creates an HTML page with a search bar, faceted navigation, and results area that includes images.
117128
+ [Create your first app in C#](tutorial-csharp-create-first-app.md) is a tutorial that builds a functional client. Sample code demonstrates paginated queries, hit highlighting, and sorting.
118129

119-
Several code samples include a web front-end interface, which you can find here: [New York City Jobs demo app](https://aka.ms/azjobsdemo), [JavaScript sample code with a live demo site](https://github.com/liamca/azure-search-javascript-samples), and [CognitiveSearchFrontEnd](https://github.com/LuisCabrer/CognitiveSearchFrontEnd).
130+
Several code samples include a web front-end interface, which you can find here: [New York City Jobs demo app](https://aka.ms/azjobsdemo), [JavaScript sample code with a live demo site](https://github.com/liamca/azure-search-javascript-samples), and [CognitiveSearchFrontEnd](https://github.com/LuisCabrer/CognitiveSearchFrontEnd).

0 commit comments

Comments
 (0)