configurable (or unlimited) hit highlights
Per https://docs.microsoft.com/en-us/rest/api/searchservice/search-documents "Azure Search returns only up to 5 highlights per field. This limit is not configurable" >> this should be changed. Either by offering a configurable threshold, by pagination or any other way. We'd need to be able to access all hit results and not just a partial subset
The limit is now configurable per field. Below is the update.
By default, Azure Search returns up to 5 highlights per field. The limit is configurable per field by appending -<max # of highlights> following the field name. For example, highlight=title-3,description-10 returns up to 3 highlighted hits from the title field and up to 10 hits from the description field. <max # of highlights> must be an integer between 1 and 1000 inclusive.
For more information, see https://docs.microsoft.com/en-us/rest/api/searchservice/search-documents