Acrolinx scores

Author: IngridAtMicrosoft

articles/azure-video-indexer/ams-deprecation-faq.yml

@@ -20,42 +20,42 @@ sections:
           
       - question:  Is Azure Video Indexer also being deprecated?
         answer: |
-          No. While Azure Video Indexer currently relies on Azure Media Services for video encoding, Azure Video Indexer is not being deprecated. 
+          No. While Azure Video Indexer currently relies on Azure Media Services for video encoding, Azure Video Indexer isn't being deprecated. 
 
       - question:  Will I be able to use Video Indexer after Media Services is deprecated?
         answer: |
           Yes, you continue to be able to use Azure Video Indexer. 
 
-      - question: What will I need to do before the deprecation?
+      - question: What do I need to do before the deprecation?
         answer: |
           We try to keep the impact of Azure Media Services deprecation to a minimum for Azure Video Indexer customers. We'll continue to inform you and post updates to our documentation when changes or actions are requires from you.  
 
       - question: Why do I still need to create a Media Services account even when it’s being deprecated?
         answer: |
-          While today you need to create an Azure Media Services account as part of Azure Video Indexer we're working on removing this dependency before Azure Media Services is fully deprecated. 
+          While today you need to create an Azure Media Services account as part of Azure Video Indexer, we're working on removing this dependency before Azure Media Services is fully deprecated. 
 
       - question: Will I see a change in features or behavior of Azure Video Indexer?
         answer: |
           Azure Video Indexer uses Azure Media Services for encoding and streaming. We'll replace these capabilities with “like for like” alternatives as much as possible. We'll continue to provide streaming capability for videos hosted through Video Indexer. 
 
       - question: Why should I move to Video Indexer ARM accounts?
         answer: |
-          ARM accounts provide enhancements for management like Monitoring, Identity Access Management, Automation and other AI Analysis capabilities. When transitioning from Media Services Analysis you get more capabilities at a lower price. 
+          ARM accounts provide enhancements for management like Monitoring, Identity Access Management, Automation and other AI Analysis capabilities. When transitioning from Media Services Analysis, you get more capabilities at a lower price. 
 
       - question: Can I use Video Indexer for encoding or streaming?
         answer: |
           No, while we use these functions as part of our product they aren't provided as standalone functionality to replace Media Services. You can find partner solutions in the Azure Marketplace. 
 
       - question:  Will my billing change after the deprecation?
         answer: |
-          Video Indexer will replace the encoding and streaming functionality provided by Media Services. What was previously billed by Media Services will now be billed by Video Indexer directly. You will not pay more for the replacement encoding and packaging service offered by Video Indexer.
+          Video Indexer will replace the encoding and streaming functionality provided by Media Services. What was previously billed by Media Services will now be billed by Video Indexer directly. You won't pay more for the replacement encoding and packaging service offered by Video Indexer.
       - question:  Can I use Video Indexer for live Analysis?
         answer: |
-          No, while Media Services provided live transcription on live events, Video Indexer does not provide live streaming or Analysis capability.
+          No, while Media Services provided live transcription on live events, Video Indexer doesn't provide live streaming or Analysis capability.
 
       - question:  What will happen to my Azure Media Services account?
         answer: |
-          Video Indexer will gradually migrate away from Azure Media Services and continue to operate without Media Services. After the migration you can follow Media Services guidance how to migrate/terminate your Media Services account.
+          Video Indexer will gradually migrate away from Azure Media Services and continue to operate without Media Services. After the migration, you can follow Media Services guidance how to migrate/terminate your Media Services account.
 
       - question: What can I do if I have more questions?
         answer: |

articles/azure-video-indexer/clapperboard-metadata.md

@@ -1,19 +1,19 @@
 ---
-title: Enable and view a clapperboard with extracted metadata
-description: Learn about how to enable and view a clapperboard with extracted metadata.
+title: Enable and view a clapper board with extracted metadata
+description: Learn about how to enable and view a clapper board with extracted metadata.
 ms.topic: article
 ms.date: 09/20/2022
 ms.author: inhenkel
 author: IngridAtMicrosoft
 ---
 
-# Enable and view a clapperboard with extracted metadata (preview)
+# Enable and view a clapper board with extracted metadata (preview)
 
-A clapperboard insight is used to detect clapperboard instances and information written on each. For example, *head* or *tail* (the board is upside-down), *production*, *roll*, *scene*, *take*, *date*, etc. The [clapperboard](https://en.wikipedia.org/wiki/Clapperboard)'s extracted metadata is most useful to customers involved in the movie post-production process. 
+A clapper board insight is used to detect clapper board instances and information written on each. For example, *head* or *tail* (the board is upside-down), *production*, *roll*, *scene*, *take*, *date*, etc. The [clapper board](https://en.wikipedia.org/wiki/Clapperboard)'s extracted metadata is most useful to customers involved in the movie post-production process. 
 
-When the movie is being edited, a clapperboard is removed from the scene; however, the information that was written on the clapperboard is important. Azure AI Video Indexer extracts the data from clapperboards, preserves, and presents the metadata. 
+When the movie is being edited, a clapper board is removed from the scene; however, the information that was written on the clapper board is important. Azure AI Video Indexer extracts the data from clapper boards, preserves, and presents the metadata. 
 
-This article shows how to enable the post-production insight and view clapperboard instances with extracted metadata.
+This article shows how to enable the post-production insight and view clapper board instances with extracted metadata.
 
 ## View the insight
 
@@ -29,16 +29,16 @@ After the file has been uploaded and indexed, if you want to view the timeline o
 > [!div class="mx-imgBorder"]
 > :::image type="content" source="./media/slate-detection-process/post-production-checkmark.png" alt-text="This image shows the post-production checkmark needed to view clapperboards.":::
 
-### Clapperboards
+### Clapper boards
 
-Clapperboards contain fields with titles (for example, *production*, *roll*, *scene*, *take*) and values (content) associated with each title. 
+Clapper boards contain fields with titles (for example, *production*, *roll*, *scene*, *take*) and values (content) associated with each title. 
 
-For example, take this clapperboard:
+For example, take this clapper board:
 
 > [!div class="mx-imgBorder"]
 > :::image type="content" source="./media/slate-detection-process/clapperboard.png" alt-text="This image shows a clapperboard.":::
 
-In the following example the board contains the following fields:
+In the following example, the board contains the following fields:
 
 |title|content|
 |---|---|
@@ -51,14 +51,14 @@ In the following example the board contains the following fields:
 
 #### View the insight
 
-To see the instances on the website, select **Insights** and scroll to **Clapperboards**. You can hover over each clapperboard, or unfold **Show/Hide clapperboard info** and see the metadata:
+To see the instances on the website, select **Insights** and scroll to **Clapper boards**. You can hover over each clapper board, or unfold **Show/Hide clapper board info** and see the metadata:
 
 > [!div class="mx-imgBorder"]
 > :::image type="content" source="./media/slate-detection-process/clapperboard-metadata.png" alt-text="This image shows the clapperboard metadata.":::
 
 #### View the timeline
 
-If you checked the **Post-production** insight, You can also find the clapperboard instance and its timeline (includes time, fields' values) on the **Timeline** tab.
+If you checked the **Post-production** insight, You can also find the clapper board instance and its timeline (includes time, fields' values) on the **Timeline** tab.
 
 #### View JSON
 
@@ -74,21 +74,21 @@ The following table describes fields found in json:
 
 |Name|Description|
 |---|---|
-|`id`|The clapperboard ID.|
+|`id`|The clapper board ID.|
 |`thumbnailId`|The ID of the thumbnail.|
 |`isHeadSlate`|The value stands for head or tail (the board is upside-down) of the clapper board: `true` or `false`.|
 |`fields`|The fields found in the clapper board; also each field's name and value.|
 |`instances`|A list of time ranges where this element appeared.|
 
-## Clapperboard limitations
+## Clapper board limitations
 
 The values may not always be correctly identified by the detection algorithm. Here are some limitations:
 
 - The titles of the fields appearing on the clapper board are optimized to identify the most popular fields appearing on top of clapper boards.  
 - Handwritten text or digital digits may not be correctly identified by the fields detection algorithm.
 - The algorithm is optimized to identify fields' categories that appear horizontally.  
-- The clapperboard may not be detected if the frame is blurred or that the text written on it can't be identified by the human eye.  
-- Empty fields’ values may lead to to wrong fields categories.  
+- The clapper board may not be detected if the frame is blurred or that the text written on it can't be identified by the human eye.  
+- Empty fields’ values may lead to wrong fields categories.  
 <!-- If a part of a clapper board is hidden a value with the highest confidence is shown.  -->
 
 ## Next steps

articles/azure-video-indexer/customize-language-model-overview.md

@@ -11,30 +11,30 @@ author: IngridAtMicrosoft
 
 Azure AI Video Indexer supports automatic speech recognition through integration with the Microsoft [Custom Speech Service](https://azure.microsoft.com/services/cognitive-services/custom-speech-service/). You can customize the Language model by uploading adaptation text, namely text from the domain whose vocabulary you'd like the engine to adapt to. Once you train your model, new words appearing in the adaptation text will be recognized, assuming default pronunciation, and the Language model will learn new probable sequences of words. See the list of supported by Azure AI Video Indexer languages in [supported langues](language-support.md). 
 
-Let's take a word that is highly specific, like *"Kubernetes"* (in the context of Azure Kubernetes service), as an example. Since the word is new to Azure AI Video Indexer, it is recognized as *"communities"*. You need to train the model to recognize it as *"Kubernetes"*. In other cases, the words exist, but the Language model is not expecting them to appear in a certain context. For example, *"container service"* is not a 2-word sequence that a non-specialized Language model would recognize as a specific set of words.
+Let's take a word that is highly specific, like *"Kubernetes"* (in the context of Azure Kubernetes service), as an example. Since the word is new to Azure AI Video Indexer, it's recognized as *"communities"*. You need to train the model to recognize it as *"Kubernetes"*. In other cases, the words exist, but the Language model isn't expecting them to appear in a certain context. For example, *"container service"* isn't a 2-word sequence that a nonspecialized Language model would recognize as a specific set of words.
 
-There are 2 ways to customize a language model:
+There are two ways to customize a language model:
 
-- **Option 1**: Edit the transcript that was generated by Azure AI Video Indexer. By editing and correcting the transcript, you are training a language model to provide improved results in the future.
+- **Option 1**: Edit the transcript that was generated by Azure AI Video Indexer. By editing and correcting the transcript, you're training a language model to provide improved results in the future.
 - **Option 2**: Upload text file(s) to train the language model. The upload file can either contain a list of words as you would like them to appear in the Video Indexer transcript or the relevant words included naturally in sentences and paragraphs. As better results are achieved with the latter approach, it's recommended for the upload file to contain full sentences or paragraphs related to your content.
 
 > [!Important]
 > Do not include in the upload file the words or sentences as currently incorrectly transcribed (for example, *"communities"*) as this will negate the intended impact. 
 > Only include the words as you would like them to appear (for example, *"Kubernetes"*).
 
-You can use the Azure AI Video Indexer APIs or the website to create and edit custom Language models, as described in topics in the [Next steps](#next-steps) section of this topic.
+You can use the Azure AI Video Indexer APIs or the website to create and edit custom Language models, as described in articles in the [Next steps](#next-steps) section of this article.
 
 ## Best practices for custom Language models
 
 Azure AI Video Indexer learns based on probabilities of word combinations, so to learn best:
 
 * Give enough real examples of sentences as they would be spoken.
 * Put only one sentence per line, not more. Otherwise the system will learn probabilities across sentences.
-* It is okay to put one word as a sentence to boost the word against others, but the system learns best from full sentences.
+* It's okay to put one word as a sentence to boost the word against others, but the system learns best from full sentences.
 * When introducing new words or acronyms, if possible, give as many examples of usage in a full sentence to give as much context as possible to the system.
 * Try to put several adaptation options, and see how they work for you.
 * Avoid repetition of the exact same sentence multiple times. It may create bias against the rest of the input.
-* Avoid including uncommon symbols (~, # @ % &) as they will get discarded. The sentences in which they appear will also get discarded.
+* Avoid including uncommon symbols (~, # @ % &) as they'll get discarded. The sentences in which they appear will also get discarded.
 * Avoid putting too large inputs, such as hundreds of thousands of sentences, because doing so will dilute the effect of boosting.
 
 ## Next steps

articles/azure-video-indexer/customize-language-model-with-api.md

@@ -14,7 +14,7 @@ Azure AI Video Indexer lets you create custom Language models to customize speec
 
 For a detailed overview and best practices for custom Language models, see [Customize a Language model with Azure AI Video Indexer](customize-language-model-overview.md).
 
-You can use the Azure AI Video Indexer APIs to create and edit custom Language models in your account, as described in this topic. You can also use the website, as described in [Customize Language model using the Azure AI Video Indexer website](customize-language-model-with-api.md).
+You can use the Azure AI Video Indexer APIs to create and edit custom Language models in your account, as described in this article. You can also use the website, as described in [Customize Language model using the Azure AI Video Indexer website](customize-language-model-with-api.md).
 
 ## Create a Language model
 
@@ -25,8 +25,8 @@ The [create a language model](https://api-portal.videoindexer.ai/api-details#api
 
 To upload files to be added to the Language model, you must upload files in the body using FormData in addition to providing values for the required parameters above. There are two ways to do this task:
 
-* Key will be the file name and value will be the txt file.
-* Key will be the file name and value will be a URL to txt file.
+* Key is the file name and value is the txt file.
+* Key is the file name and value is a URL to txt file.
 
 ### Response
 
@@ -100,7 +100,7 @@ The returned `id` is a unique ID used to distinguish between language models, wh
 
 ## Delete a Language model
 
-The [delete a language model](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Delete-Language-Model) API deletes a custom Language model from the specified account. Any video that was using the deleted Language model will keep the same index until you reindex the video. If you reindex the video, you can assign a new Language model to the video. Otherwise, Azure AI Video Indexer will use its default model to reindex the video.
+The [delete a language model](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Delete-Language-Model) API deletes a custom Language model from the specified account. Any video that was using the deleted Language model keeps the same index until you reindex the video. If you reindex the video, you can assign a new Language model to the video. Otherwise, Azure AI Video Indexer uses its default model to reindex the video.
 
 ### Response
 
@@ -115,8 +115,8 @@ The [update a Language model](https://api-portal.videoindexer.ai/api-details#api
 
 To upload files to be added to the Language model, you must upload files in the body using FormData in addition to providing values for the required parameters above. There are two ways to do this task:
 
-* Key will be the file name and value will be the txt file.
-* Key will be the file name and value will be a URL to txt file.
+* Key is the file name and value is the txt file.
+* Key is the file name and value is a URL to txt file.
 
 ### Response
 
@@ -286,7 +286,7 @@ The [download a file](https://api-portal.videoindexer.ai/api-details#api=Operati
 
 ### Response
 
-The response will be the download of a text file with the contents of the file in the JSON format.
+The response is the download of a text file with the contents of the file in the JSON format.
 
 ## Next steps