Merge pull request #1617 from HeidiSteen/main

[azure search] Portal BYOE updates based on feedback

Author: prmerger-automator[bot]

articles/search/search-get-started-portal-image-search.md

@@ -28,6 +28,8 @@ Sample data consists of image files in the [azure-search-sample-data](https://gi
 
   The service tier determines how many blobs you can index. We used the Free tier to create this walkthrough and limited the content to 10 JPG files.
 
++ Familiarity with the wizard. See [Import data wizards in the Azure portal](search-import-data-portal.md) for details.
+
 + Azure Storage to store image files as blobs. Use Azure Blob Storage or Azure Data Lake Storage Gen2 (a storage account with a hierarchical namespace), a standard performance (general-purpose v2) account. Access tiers can be hot, cool, and cold.
 
 All of the preceding resources must have public access enabled so that the portal nodes can access them. Otherwise, the wizard fails. After the wizard runs, you can enable firewalls and private endpoints on the integration components for security. For more information, see [Secure connections in the import wizards](search-import-data-portal.md#secure-connections).

articles/search/search-get-started-portal-import-vectors.md

@@ -25,6 +25,8 @@ This quickstart helps you get started with [integrated vectorization](vector-sea
 
 + [A supported embedding model](#supported-embedding-models).
 
++ Familiarity with the wizard. See [Import data wizards in the Azure portal](search-import-data-portal.md) for details.
+
 ### Supported data sources
 
 The **Import and vectorize data** wizard [supports a wide range of Azure data sources](search-import-data-portal.md#supported-data-sources-and-scenarios), but this quickstart provides steps for just those data sources that work with whole files:

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

@@ -26,7 +26,9 @@ The wizard creates multiple objects on your search service - [searchable index](
 
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/).
 
-- An Azure AI Search service for any tier and any region. [Create a service](search-create-service-portal.md) or [find an existing service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices) under your current subscription. You can use a free service for this quickstart. 
+- An Azure AI Search service for any tier and any region. [Create a service](search-create-service-portal.md) or [find an existing service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices) under your current subscription. You can use a free service for this quickstart.
+
+- Familiarity with the wizard. See [Import data wizards in the Azure portal](search-import-data-portal.md) for details.
 
 For this quickstart, which uses built-in sample data, make sure the search service doesn't have [network access controls](service-configure-firewall.md) in place. The portal controller uses the public endpoint to retrieve data and metadata from the built-in sample data source hosted by Microsoft. For more information, see [Secure connections in the import wizards](search-import-data-portal.md#secure-connections).
 

articles/search/search-import-data-portal.md

@@ -36,16 +36,16 @@ The wizards support most of the data sources supported by indexers.
 | Data | Import data wizard | Import and vectorize data wizard |
 |------|--------------------|----------------------------------|
 | [ADLS Gen2](search-howto-index-azure-data-lake-storage.md)  | ✅ | ✅ |
-| [Azure blobs](search-howto-indexing-azure-blob-storage.md) | ✅ | ✅ |
-| [Azure files](search-file-storage-integration.md)  | ✅ | ❌ |
-| [Azure tables](search-howto-indexing-azure-tables.md)  | ✅ | ✅ |
+| [Azure Blob Storage](search-howto-indexing-azure-blob-storage.md) | ✅ | ✅ |
+| [Azure File Storage](search-file-storage-integration.md)  | ❌ | ❌ |
+| [Azure Table Storage](search-howto-indexing-azure-tables.md)  | ✅ | ✅ |
 | [Azure SQL database and managed instance](search-how-to-index-sql-database.md)  | ✅ | ✅ |
 | [Cosmos DB for NoSQL](search-howto-index-cosmosdb.md) | ✅ | ✅ |
-| [Cosmos DB for MongoDB](search-howto-index-cosmosdb-mongodb.md) | ✅ | ❌ |
+| [Cosmos DB for MongoDB](search-howto-index-cosmosdb-mongodb.md) | ✅ | ✅ |
 | [Cosmos DB for Apache Gremlin](search-howto-index-cosmosdb-gremlin.md) | ✅ | ❌ |
 | [MySQL](search-howto-index-mysql.md)  | ✅ | ❌ |
 | [OneLake](search-how-to-index-onelake-files.md)  | ✅ | ✅ |
-| [SharePoint Online](search-howto-index-sharepoint-online.md)  | ✅ | ❌ |
+| [SharePoint Online](search-howto-index-sharepoint-online.md)  | ❌ | ❌ |
 | [SQL Server on virtual machines](search-how-to-index-sql-server.md)  | ✅ | ❌ |
 
 ### Sample data
@@ -59,9 +59,13 @@ Microsoft hosts sample data so that you can omit a data source configuration ste
 
 ### Skills
 
-The wizards generate skillset and output field mappings based on options you select. You can modify a skillset's JSON definition to add more skills later.
+This section lists the skills that might appear in a skillset generated by a wizard. Wizards generate a skillset and output field mappings based on options you select. After the skillset is created, you can modify its JSON definition to add more skills.
 
-OCR and image analysis options are available for blobs and whole-file indexing in OneLake, assuming the default parsing mode. Shaper is added if you configure a knowledge store. Text Split and Text Merge are added for data chunking if you choose an embedding model, and for other skills if the granularity is set to pages or sentences.
+Here are some points to keep in mind about the skills in the following list:
+
++ OCR and image analysis options are available for blobs in Azure Storage and files in OneLake, assuming the default parsing mode. Images are either an image content type (such as PNG or JPG) or an embedded image in an application file (such as PDF).
++ Shaper is added if you configure a knowledge store.
++ Text Split and Text Merge are added for data chunking if you choose an embedding model. They are added for other non-embedding skills if the source field granularity is set to pages or sentences.
 
 | Skills | Import data wizard | Import and vectorize data wizard |
 |------|--------------------|----------------------------------|