Merge pull request #108155 from nicoalba/mediaseo4

Media Services edits -- Style and SEO #4

Author: American-Dipper

articles/machine-learning/how-to-consume-web-service.md

@@ -42,7 +42,7 @@ The [azureml.core.Webservice](https://docs.microsoft.com/python/api/azureml-core
 * `auth_enabled` - If key authentication is enabled, `True`; otherwise, `False`.
 * `token_auth_enabled` - If token authentication is enabled, `True`; otherwise, `False`.
 * `scoring_uri` - The REST API address.
-* `swagger_uri` - The address of the OpenAPI specification. This URI is available if you enabled automatic schema generation. For more information, see [Deploy models with Azure Machine Learning](how-to-deploy-and-where.md#optional-define-model-web-service-schema).
+* `swagger_uri` - The address of the OpenAPI specification. This URI is available if you enabled automatic schema generation. For more information, see [Deploy models with Azure Machine Learning](how-to-deploy-and-where.md).
 
 There are a three ways to retrieve this information for deployed web services:
 

articles/media-services/latest/scale-streaming-cdn.md

@@ -1,11 +1,10 @@
 ---
-title: Use Azure Video Indexer to customize Brands model
+title: Customize a Brands model with Video Indexer API
 titleSuffix: Azure Media Services
-description: This article demonstrates how to use Azure Video Indexer to customize Brands model.
+description: Learn how to customize a Brands model with the Video Indexer API.
 services: media-services
 author: anikaz
 manager: johndeu
-
 ms.service: media-services
 ms.subservice: video-indexer
 ms.topic: article
@@ -15,23 +14,23 @@ ms.author: anzaman
 
 # Customize a Brands model with the Video Indexer API
 
-Video Indexer supports brand detection from speech and visual text during indexing and reindexing of video and audio content. The brand detection feature identifies mentions of products, services, and companies suggested by Bing's brands database. For example, if Microsoft is mentioned in a video or audio content or if it shows up in visual text in a video, Video Indexer detects it as a brand in the content. A custom Brands model allows you to exclude certain brands from being detected and include brands that should be part of your model that might not be in Bing's brands database.
+Video Indexer supports brand detection from speech and visual text during indexing and reindexing of video and audio content. The brand detection feature identifies mentions of products, services, and companies suggested by Bing's brands database. For example, if Microsoft is mentioned in video or audio content or if it shows up in visual text in a video, Video Indexer detects it as a brand in the content. A custom Brands model allows you to exclude certain brands from being detected and include brands that should be part of your model that might not be in Bing's brands database.
 
 For a detailed overview, see [Overview](customize-brands-model-overview.md).
 
 You can use the Video Indexer APIs to create, use, and edit custom Brands models detected in a video, as described in this topic. You can also use the Video Indexer website, as described in [Customize Brands model using the Video Indexer website](customize-brands-model-with-api.md).
 
 ## Create a Brand
 
-The [create a brand](https://api-portal.videoindexer.ai/docs/services/operations/operations/Create-Brand) API creates a new custom brand and adds it to the custom Brands model for the specified account. 
+The [create a brand](https://api-portal.videoindexer.ai/docs/services/operations/operations/Create-Brand) API creates a new custom brand and adds it to the custom Brands model for the specified account.
 
 > [!NOTE]
-> Setting **enabled** (in the body) to true puts the brand in the *Include* list for Video Indexer to detect. Setting **enabled** to false puts the brand in the *Exclude* list, so Video Indexer will not detect it.
+> Setting `enabled` (in the body) to true puts the brand in the *Include* list for Video Indexer to detect. Setting `enabled` to false puts the brand in the *Exclude* list, so Video Indexer won't detect it.
 
 Some other parameters that you can set in the body:
 
-* The **referenceUrl** value can be any reference websites for the brand such as a link to its Wikipedia page.
-* The **tags** value is a list of tags for the brand. This shows up in the brand's *Category* field in the Video Indexer website. For example, the brand "Azure" can be tagged or categorized as "Cloud".
+* The `referenceUrl` value can be any reference websites for the brand, such as a link to its Wikipedia page.
+* The `tags` value is a list of tags for the brand. This tag shows up in the brand's *Category* field in the Video Indexer website. For example, the brand "Azure" can be tagged or categorized as "Cloud".
 
 ### Response
 
@@ -57,11 +56,11 @@ The response provides information on the brand that you just created following t
 
 ## Delete a Brand
 
-The [delete a brand](https://api-portal.videoindexer.ai/docs/services/operations/operations/Delete-Brand?) API removes a brand from the custom Brands model for the specified account. The account is specified in the **accountId** parameter. Once called successfully, the brand will no longer be in the *Include* or *Exclude* brands lists.
+The [delete a brand](https://api-portal.videoindexer.ai/docs/services/operations/operations/Delete-Brand?) API removes a brand from the custom Brands model for the specified account. The account is specified in the `accountId` parameter. Once called successfully, the brand will no longer be in the *Include* or *Exclude* brands lists.
 
 ### Response
 
-There is no returned content when the brand is deleted successfully.
+There's no returned content when the brand is deleted successfully.
 
 ## Get a specific Brand
 
@@ -90,7 +89,7 @@ The response provides information on the brand that you searched (using brand ID
 ```
 
 > [!NOTE]
-> **enabled** being set to **true** signifies that the brand is in the *Include* list for Video Indexer to detect, and **enabled** being false signifies that the brand is in the *Exclude* list, so Video Indexer will not detect it.
+> `enabled` being set to `true` signifies that the brand is in the *Include* list for Video Indexer to detect, and `enabled` being false signifies that the brand is in the *Exclude* list, so Video Indexer won't detect it.
 
 ## Update a specific brand
 
@@ -156,11 +155,11 @@ The response provides a list of all of the brands in your account and each of th
 ```
 
 > [!NOTE]
-> The brand named *Example* is in the *Include* list for Video Indexer to detect, and the brand named *Example2* is in the *Exclude* list, so Video Indexer will not detect it.
+> The brand named *Example* is in the *Include* list for Video Indexer to detect, and the brand named *Example2* is in the *Exclude* list, so Video Indexer won't detect it.
 
 ## Get Brands model settings
 
-The [get brands settings](https://api-portal.videoindexer.ai/docs/services/operations/operations/Get-Brands) API returns the Brands model settings in the specified account. The Brands model settings represent whether detection from the Bing brands database is enabled or not. If Bing brands are not enabled, Video Indexer will only detect brands from the custom Brands model of the specified account.
+The [get brands settings](https://api-portal.videoindexer.ai/docs/services/operations/operations/Get-Brands) API returns the Brands model settings in the specified account. The Brands model settings represent whether detection from the Bing brands database is enabled or not. If Bing brands aren't enabled, Video Indexer will only detect brands from the custom Brands model of the specified account.
 
 ### Response
 
@@ -174,17 +173,17 @@ The response shows whether Bing brands are enabled following the format of the e
 ```
 
 > [!NOTE]
-> **useBuiltIn** being set to true represents that Bing brands are enabled. If *useBuiltin* is false, Bing brands are disabled. The **state** value can be ignored as it has been deprecated.
+> `useBuiltIn` being set to true represents that Bing brands are enabled. If `useBuiltin` is false, Bing brands are disabled. The `state` value can be ignored because it has been deprecated.
 
 ## Update Brands model settings
 
-The [update brands](https://api-portal.videoindexer.ai/docs/services/operations/operations/Update-Brands-Model-Settings?) updates the Brands model settings in the specified account. The Brands model settings represent whether detection from the Bing brands database is enabled or not. If Bing brands are not enabled, Video Indexer will only detect brands from the custom Brands model of the specified account.
+The [update brands](https://api-portal.videoindexer.ai/docs/services/operations/operations/Update-Brands-Model-Settings?) API updates the Brands model settings in the specified account. The Brands model settings represent whether detection from the Bing brands database is enabled or not. If Bing brands aren't enabled, Video Indexer will only detect brands from the custom Brands model of the specified account.
 
-The **useBuiltIn** flag set to true represents that Bing brands are enabled. If *useBuiltin* is false, Bing brands are disabled.
+The `useBuiltIn` flag set to true means that Bing brands are enabled. If `useBuiltin` is false, Bing brands are disabled.
 
 ### Response
 
-There is no returned content when the Brands model setting is updated successfully.
+There's no returned content when the Brands model setting is updated successfully.
 
 ## Next steps
 

articles/media-services/video-indexer/customize-brands-model-with-api.md

@@ -1,11 +1,10 @@
 ---
-title: Use the Video Indexer website to customize Brands models - Azure 
+title: Customize a Brands model with the Video Indexer website
 titleSuffix: Azure Media Services
-description: This article shows how to customize a Brands model with the Video Indexer website.
+description: Learn how to customize a Brands model with the Video Indexer website.
 services: media-services
 author: anikaz
 manager: johndeu
-
 ms.service: media-services
 ms.subservice: video-indexer
 ms.topic: article
@@ -15,75 +14,87 @@ ms.author: anzaman
 
 # Customize a Brands model with the Video Indexer website
 
-Video Indexer supports brand detection from speech and visual text during indexing and reindexing of video and audio content. The brand detection feature identifies mentions of products, services, and companies suggested by Bing's brands database. For example, if Microsoft is mentioned in a video or audio content or if it shows up in visual text in a video, Video Indexer detects it as a brand in the content. A custom Brands model allows you to select whether or not you Video Indexer will detect brands from the Bing brands database, exclude certain brands from being detected (essentially creating a black list of brands), and include brands that should be part of your model that might not be in Bing's brands database (essentially creating a white list of brands).
+Video Indexer supports brand detection from speech and visual text during indexing and reindexing of video and audio content. The brand detection feature identifies mentions of products, services, and companies suggested by Bing's brands database. For example, if Microsoft is mentioned in video or audio content or if it shows up in visual text in a video, Video Indexer detects it as a brand in the content.
+
+A custom Brands model allows you to:
+
+- select if you want Video Indexer to detect brands from the Bing brands database.
+- select if you want Video Indexer to exclude certain brands from being detected (essentially creating a deny list of brands).
+- select if you want Video Indexer to include brands that should be part of your model that might not be in Bing's brands database (essentially creating an accept list of brands).
 
-For a detailed overview, see [Overview](customize-brands-model-overview.md).
+For a detailed overview, see this [Overview](customize-brands-model-overview.md).
 
 You can use the Video Indexer website to create, use, and edit custom Brands models detected in a video, as described in this topic. You can also use the API, as described in [Customize Brands model using APIs](customize-brands-model-with-api.md).
 
-## Edit the settings of the Brands model  
+## Edit Brands model settings
+
+You have the option to set whether or not you want brands from the Bing brands database to be detected. To set this option, you need to edit the settings of your Brands model. Follow these steps:
+
+1. Go to the [Video Indexer](https://www.videoindexer.ai/) website and sign in.
+2. To customize a model in your account, select the **Content model customization** button on the top-right corner of the page.
 
-You have the option to set whether or not you want brands from the Bing brands database to be detected. For this, you need to edit the settings of your Brands model.
+   ![Customize content model in Video Indexer](./media/content-model-customization/content-model-customization.png)
 
-1. Browse to the [Video Indexer](https://www.videoindexer.ai/) website and sign in.
-2. To customize a model in your account, click on the **Content model customization** button on the top-right corner of the page.
- 
-   ![Customize content model](./media/content-model-customization/content-model-customization.png) 
 3. To edit brands, select the **Brands** tab.
 
-    ![Customize brands model](./media/customize-brand-model/customize-brand-model.png)
-4. Check the **Show brands suggested by Bing** option, if you want for Video Indexer to include brands suggested by Bing. Leave the option unchecked if you do not want Video Indexer to detect brands suggested by Bing in your content. 
+    ![Customize brands model in Video Indexer](./media/customize-brand-model/customize-brand-model.png)
+
+4. Check the **Show brands suggested by Bing** option if you want Video Indexer to detect brands suggested by Bing—leave the option unchecked if you don't.
 
 ## Include brands in the model
 
-The **Include brands** section represents custom brands that you want for Video Indexer to detect even if they are not suggested by Bing.  
+The **Include brands** section represents custom brands that you want Video Indexer to detect, even if they aren't suggested by Bing.  
 
-### Add a brand
+### Add a brand to include list
 
-1. Click "+ Add brand".
+1. Select **+ Add brand**.
 
-    ![Customize brands model](./media/customize-brand-model/add-brand.png)
+    ![Customize brands model in Video Indexer](./media/customize-brand-model/add-brand.png)
 
     Provide a name (required), category (optional), description (optional), and reference URL (optional).
     The category field is meant to help you tag your brands. This field shows up as the brand's *tags* when using the Video Indexer APIs. For example, the brand "Azure" can be tagged or categorized as "Cloud".
 
-    The reference URL field can be any reference website for the brand such as a link to its Wikipedia page.
-2. Click "Add brand" and you will see that the brand has been added to the **Include brands** list.
+    The reference URL field can be any reference website for the brand (like a link to its Wikipedia page).
+
+2. Select **Add brand** and you'll see that the brand has been added to the **Include brands** list.
 
-### Edit a brand
+### Edit a brand on the include list
 
-1. Click on the pencil icon next to the brand that you want to edit.
+1. Select the pencil icon next to the brand that you want to edit.
 
     You can update the category, description, or reference URL of a brand. You can't change the name of a brand because names of brands are unique. If you need to change the brand name, delete the entire brand (see next section) and create a new brand with the new name.
-2. Click the **Update** button to update the brand with the new information.
 
-### Delete a brand
+2. Select the **Update** button to update the brand with the new information.
+
+### Delete a brand on the include list
 
-1. Click on the trash icon next to the brand that you want to delete.
-2. Click "Delete" and the brand will no longer appear in your *Include brands* list.
+1. Select the trash icon next to the brand that you want to delete.
+2. Select **Delete** and the brand will no longer appear in your *Include brands* list.
 
 ## Exclude brands from the model
 
-The **Exclude brands** section represents the brands that you want for Video Indexer not to detect.
+The **Exclude brands** section represents the brands that you don't want Video Indexer to detect.
 
-### Add a brand
+### Add a brand to exclude list
 
-1. Click "+ Add brand".
+1. Select **+ Add brand.**
 
     Provide a name (required), category (optional).
-2. Click "Add brand" and you will see that the brand has been added to the *Exclude brands* list.
 
-### Edit a Brand
+2. Select **Add brand** and you'll see that the brand has been added to the *Exclude brands* list.
 
-1. Click on the pencil icon next to the brand that you want to edit.
+### Edit a brand on the exclude list
+
+1. Select the pencil icon next to the brand that you want to edit.
 
     You can only update the category of a brand. You can't change the name of a brand because names of brands are unique. If you need to change the brand name, delete the entire brand (see next section) and create a new brand with the new name.
-2. Click the **Update** button to update the brand with the new information.
 
-### Delete a Brand
+2. Select the **Update** button to update the brand with the new information.
+
+### Delete a brand on the exclude list
 
-1. Click on the trash icon next to the brand that you want to delete.
-2. Click "Delete" and the brand will no longer appear in your *Exclude brands* list.
+1. Select the trash icon next to the brand that you want to delete.
+2. Select **Delete** and the brand will no longer appear in your *Exclude brands* list.
 
 ## Next steps