formatting for readability

Author: HeidiSteen

articles/search/search-get-started-rag.md

@@ -324,7 +324,8 @@ If your index has complex types, your query can provide those fields if you firs
 import json
 
 # Query is the question being asked. It's sent to the search engine and the LLM.
-query="Can you recommend a few hotels that offer complimentary breakfast? Tell me their description, address, tags, and the rate for one room they have which sleep 4 people."
+query="Can you recommend a few hotels that offer complimentary breakfast? 
+Tell me their description, address, tags, and the rate for one room that sleeps 4 people."
 
 # Set up the search results and the chat thread.
 # Retrieve the selected fields from the search index related to the question.
@@ -354,28 +355,34 @@ print(response.choices[0].message.content)
 Output is from Azure OpenAI, and it adds content from complex types.
 
 ```
-Absolutely! Here are a few hotels that offer complimentary breakfast:
+Here are a few hotels that offer complimentary breakfast and have rooms that sleep 4 people:
 
 1. **Head Wind Resort**
-   - **Description:** The best of old town hospitality combined with views of the river and cool breezes off the prairie. Enjoy a complimentary continental breakfast in the lobby, and free Wi-Fi throughout the hotel.
+   - **Description:** The best of old town hospitality combined with views of the river and 
+   cool breezes off the prairie. Enjoy a complimentary continental breakfast in the lobby, 
+   and free Wi-Fi throughout the hotel.
    - **Address:** 7633 E 63rd Pl, Tulsa, OK 74133, USA
    - **Tags:** Coffee in lobby, free Wi-Fi, view
    - **Room for 4:** Suite, 2 Queen Beds (Amenities) - $254.99
 
 2. **Double Sanctuary Resort**
-   - **Description:** 5-star Luxury Hotel - Biggest Rooms in the city. #1 Hotel in the area listed by Traveler magazine. Free WiFi, Flexible check in/out, Fitness Center & espresso in room. Offers continental breakfast.
+   - **Description:** 5-star Luxury Hotel - Biggest Rooms in the city. #1 Hotel in the area 
+   listed by Traveler magazine. Free WiFi, Flexible check in/out, Fitness Center & espresso 
+   in room. Offers continental breakfast.
    - **Address:** 2211 Elliott Ave, Seattle, WA 98121, USA
    - **Tags:** View, pool, restaurant, bar, continental breakfast
    - **Room for 4:** Suite, 2 Queen Beds (Amenities) - $254.99
 
 3. **Swan Bird Lake Inn**
-   - **Description:** Continental-style breakfast featuring a variety of food and drinks. Locally made caramel cinnamon rolls are a favorite.
+   - **Description:** Continental-style breakfast featuring a variety of food and drinks. 
+   Locally made caramel cinnamon rolls are a favorite.
    - **Address:** 1 Memorial Dr, Cambridge, MA 02142, USA
    - **Tags:** Continental breakfast, free Wi-Fi, 24-hour front desk service
    - **Room for 4:** Budget Room, 2 Queen Beds (City View) - $85.99
 
 4. **Gastronomic Landscape Hotel**
-   - **Description:** Known for its culinary excellence under the management of William Dough, offers continental breakfast.
+   - **Description:** Known for its culinary excellence under the management of William Dough, 
+   offers continental breakfast.
    - **Address:** 3393 Peachtree Rd, Atlanta, GA 30326, USA
    - **Tags:** Restaurant, bar, continental breakfast
    - **Room for 4:** Budget Room, 2 Queen Beds (Amenities) - $66.99

articles/search/search-howto-complex-data-types.md

@@ -289,9 +289,13 @@ To filter on a complex collection field, you can use a **lambda expression** wit
 
 As with top-level simple fields, simple subfields of complex fields can only be included in filters if they have the **filterable** attribute set to `true` in the index definition. For more information, see the [Create Index API reference](/rest/api/searchservice/indexes/create).
 
-Azure AI Search limits complex objects in a collection to 3,000 objects per document. Exceeding this limit results in the following message:
+### Workaround for the complex collection limit
 
-`"A collection in your document exceeds the maximum elements across all complex collections limit. The document with key '1052' has '4303' objects in collections (JSON arrays). At most '3000' objects are allowed to be in collections across the entire document. Remove objects from collections and try indexing the document again."`
+Recall that Azure AI Search limits complex objects in a collection to 3,000 objects per document. Exceeding this limit results in the following message:
+
+```
+A collection in your document exceeds the maximum elements across all complex collections limit. The document with key '1052' has '4303' objects in collections (JSON arrays). At most '3000' objects are allowed to be in collections across the entire document. Remove objects from collections and try indexing the document again."
+```
 
 If you need more than 3,000 items, you can pipe (`|`) or use any form of delimiter to delimit the values, concatenate them, and store them as a delimited string. There's no limitation on the number of strings stored in an array. Storing complex values as strings bypasses the complex collection limitation.
 
@@ -343,11 +347,13 @@ foreach (var filterItem in filterCombinations)
 
 The following list provides inputs and search strings (outputs) side by side:
 
-For "FRA" county code and the "1234" product code, the formatted output is ```|FRA|1234|*|```.
-For "1234" product code, the formatted output is ```|*|1234|*|```.
-For "C100" category code, the formatted output is ```|*|*|C100|```.
++ For "FRA" county code and the "1234" product code, the formatted output is ```|FRA|1234|*|```.
+
++ For "1234" product code, the formatted output is ```|*|1234|*|```.
+
++ For "C100" category code, the formatted output is ```|*|*|C100|```.
 
-Only provide the wild card entry placeholder if you're implementing the string array workaround. Otherwise, if you're using a complex type, your filter might look this example:
+Only provide the wildcard (`*`) if you're implementing the string array workaround. Otherwise, if you're using a complex type, your filter might look like this example:
 
 ```csharp
 var countryFilter = $"searchScope/any(ss: search.in(countryCode ,'FRA'))";

articles/search/search-limits-quotas-capacity.md

@@ -53,7 +53,7 @@ Maximum limits on storage, workloads, and quantities of indexes and other object
 
 <sup>2</sup> The upper limit on fields includes both first-level fields and nested subfields in a complex collection. For example, if an index contains 15 fields and has two complex collections with five subfields each, the field count of your index is 25. Indexes with a very large fields collection can be slow. [Limit fields and attributes](search-what-is-an-index.md#physical-structure-and-size) to just those you need, and run indexing and query test to ensure performance is acceptable.
 
-<sup>3</sup> An upper limit exists for elements because having a large number of them significantly increases the storage required for your index. An element of a complex collection is defined as a member of that collection. For example, assume a [Hotel document with a Rooms complex collection](search-howto-complex-data-types.md#indexing-complex-types), each room in the Rooms collection is considered an element. During indexing, the indexing engine can safely process a maximum of 3,000 elements across the document as a whole. [This limit](search-api-migration.md#upgrade-to-2019-05-06) was introduced in `api-version=2019-05-06` and applies to complex collections only, and not to string collections or to complex fields.
+<sup>3</sup> An upper limit exists for elements because having a large number of them significantly increases the storage required for your index. An element of a complex collection is defined as a member of that collection. For example, assume a [Hotel document with a Rooms complex collection](search-howto-complex-data-types.md#complex-collection-limits), each room in the Rooms collection is considered an element. During indexing, the indexing engine can safely process a maximum of 3,000 elements across the document as a whole. [This limit](search-api-migration.md#upgrade-to-2019-05-06) was introduced in `api-version=2019-05-06` and applies to complex collections only, and not to string collections or to complex fields.
 
 <sup>4</sup> On most tiers, maximum index size is all available storage on your search service. For S2, S3, and S3 HD, the maximum size of any index is the number provided in the table. Applies to search services created after April 3, 2024.