Merge pull request #266288 from MicrosoftDocs/main

02/14 AM Publishing

Author: v-alje

CONTRIBUTING.md

@@ -2,7 +2,7 @@
 
 Thank you for taking the time to contribute to the Microsoft Azure documentation.
 
-This guide covers some general topics related to contribution and refers to our [contributor guide](/contribute/content) for more detailed explanations when required.
+This guide covers some general topics related to contribution and refers to our [contributor guide](https://learn.microsoft.com/contribute/content) for more detailed explanations when required.
 
 ## Code of Conduct
 
@@ -22,8 +22,8 @@ Please use the Feedback tool at the bottom of any article to submit bugs and sug
 
 ### Edit in GitHub
 
-Follow the guidance for [Quick edits to existing documents](/contribute/content/#quick-edits-to-documentation) in our contributor guide.
+Follow the guidance for [editing documentation in the browser](https://learn.microsoft.com/contribute/content/how-to-write-quick-edits) in our contributor guide.
 
 ## Pull requests
 
-Review the guidance for [pull-request processing](/contribute/content/process-pull-request) in our contributor guide.
+Review the guidance for [pull-request processing](https://learn.microsoft.com/contribute/content/process-pull-request) in our contributor guide.

articles/active-directory-b2c/best-practices.md

@@ -9,7 +9,7 @@ manager: CelesteDG
 ms.service: active-directory
 
 ms.topic: conceptual
-ms.date: 01/11/2024
+ms.date: 02/05/2024
 ms.subservice: B2C
 
 
@@ -25,6 +25,7 @@ The following best practices and recommendations cover some of the primary aspec
 
 | Best practice | Description |
 |--|--|
+| Create emergency access account | This emergency access account helps you gain access to your Azure AD B2C tenant in circumstances such as the only administrator is unreachable when the credential is needed. [Learn how to create an emergency access account](tenant-management-emergency-access-account.md#create-emergency-access-account)  |
 | Choose user flows for most scenarios | The Identity Experience Framework of Azure AD B2C is the core strength of the service. Policies fully describe identity experiences such as sign-up, sign-in, or profile editing. To help you set up the most common identity tasks, the Azure AD B2C portal includes predefined, configurable policies called user flows. With user flows, you can create great user experiences in minutes, with just a few clicks. [Learn when to use user flows vs. custom policies](user-flow-overview.md#comparing-user-flows-and-custom-policies).|
 | App registrations | Every application (web, native) and API that is being secured must be registered in Azure AD B2C. If an app has both a web and native version of iOS and Android, you can register them as one application in Azure AD B2C with the same client ID. Learn how to [register OIDC, SAML, web, and native apps](./tutorial-register-applications.md?tabs=applications). Learn more about [application types that can be used in Azure AD B2C](./application-types.md). |
 | Move to monthly active users billing | Azure AD B2C has moved from monthly active authentications to monthly active users (MAU) billing. Most customers will find this model cost-effective. [Learn more about monthly active users billing](https://azure.microsoft.com/updates/mau-billing/). |

articles/ai-services/immersive-reader/index.yml

@@ -10,7 +10,7 @@ metadata:
   ms.topic: landing-page
   author: rwallerms
   ms.author: rwaller
-  ms.date: 11/15/2021
+  ms.date: 02/07/2024
 
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
@@ -26,7 +26,7 @@ landingContent:
             url: ../../ai-services/what-are-ai-services.md
       - linkListType: video
         links:
-          - text: Getting started - short engineering videos
+          - text: Short videos to get started
             url: https://aka.ms/ImmersiveReaderSDKVideos
 
   - title: Get started
@@ -43,11 +43,11 @@ landingContent:
           url: ./quickstarts/client-libraries.md?pivots=programming-language-kotlin
         - text: Use Swift (iOS)
           url: ./quickstarts/client-libraries.md?pivots=programming-language-swift
-  - title: Explore Immersive Reader
+  - title: Explore
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: Create an Immersive Reader Resource
+          - text: Create an Immersive Reader resource
             url: how-to-create-immersive-reader.md
           - text: Launch the Immersive Reader
             url: how-to-launch-immersive-reader.md
@@ -71,7 +71,7 @@ landingContent:
         links:
           - text: JavaScript SDK
             url: reference.md
-          - text: Security Advisory - Update Role Assignment for Microsoft Entra authentication
+          - text: Security Advisory - Update Microsoft Entra role assignment
             url: security-how-to-update-role-assignment.md            
           - text: Release notes
             url: release-notes.md

articles/ai-services/immersive-reader/language-support.md

@@ -1,20 +1,19 @@
 ---
-title: Language support - Immersive Reader
+title: Language support for Immersive Reader
 titleSuffix: Azure AI services
-description: Learn more about the human languages that are available with Immersive Reader.
+description: Learn more about the human languages that Immersive Reader supports.
 #services: cognitive-services
 author: rwallerms
 manager: nitinme
 ms.service: azure-ai-immersive-reader
 ms.topic: conceptual
-ms.date: 11/15/2021
+ms.date: 02/07/2024
 ms.author: rwaller
 ---
 
-# Language support for Immersive Reader
-
-This article lists supported human languages for Immersive Reader features.
+# Language support for Azure AI Immersive Reader
 
+Immersive Reader supports the following human languages.
 
 ## Text to speech
 

articles/ai-services/immersive-reader/overview.md

@@ -1,14 +1,14 @@
 ---
 title: What is Azure AI Immersive Reader?
 titleSuffix: Azure AI services
-description: Immersive Reader is a tool that is designed to help people with learning differences or help new readers and language learners with reading comprehension.
+description: Learn how you can use Immersive Reader to help people with learning differences or help new readers and language learners improve reading comprehension.
 #services: cognitive-services
 author: rwallerms
 manager: nitinme
 
 ms.service: azure-ai-immersive-reader
 ms.topic: overview
-ms.date: 11/15/2021
+ms.date: 02/12/2024
 ms.author: rwaller
 keywords: readers, language learners, display pictures, improve reading, read content, translate
 #Customer intent: As a developer, I want to learn more about the Immersive Reader, which is a new offering in Azure AI services, so that I can embed this package of content into a document to accommodate users with reading differences.
@@ -18,59 +18,59 @@ keywords: readers, language learners, display pictures, improve reading, read co
 
 [!INCLUDE [Azure AI services rebrand](../includes/rebrand-note.md)]
 
-[Immersive Reader](https://www.onenote.com/learningtools) is part of [Azure AI services](../../ai-services/what-are-ai-services.md), and is an inclusively designed tool that implements proven techniques to improve reading comprehension for new readers, language learners, and people with learning differences such as dyslexia. With the Immersive Reader client library, you can leverage the same technology used in Microsoft Word and Microsoft One Note to improve your web applications. 
+[Immersive Reader](https://www.onenote.com/learningtools), part of [Azure AI services](../../ai-services/what-are-ai-services.md), is an inclusively designed tool that implements proven techniques to improve reading comprehension for new readers, language learners, and people with learning differences such as dyslexia. With the Immersive Reader client library, you can leverage the same technology used in Microsoft Word and Microsoft OneNote to improve your web applications.
 
 This documentation contains the following types of articles:  
 
-* **[Quickstarts](quickstarts/client-libraries.md)** are getting-started instructions to guide you through making requests to the service.
+* **[Quickstart guides](quickstarts/client-libraries.md)** provide instructions to help you get started making requests to the service.
 * **[How-to guides](how-to-create-immersive-reader.md)** contain instructions for using the service in more specific or customized ways.
 
-## Use Immersive Reader to improve reading accessibility 
+## Use Immersive Reader to improve reading accessibility
 
-Immersive Reader is designed to make reading easier and more accessible for everyone. Let's take a look at a few of Immersive Reader's core features.
+Immersive Reader is designed to make reading easier and more accessible for everyone. Take a look at a few of Immersive Reader's core features.
 
 ### Isolate content for improved readability
 
-Immersive Reader isolates content to improve readability. 
+Immersive Reader isolates content to improve readability.
 
-  ![Isolate content for improved readability with Immersive Reader](./media/immersive-reader.png)
+:::image type="content" source="media/immersive-reader.png" alt-text="Screenshot of Immersive Reader that shows how it isolates content for improved readability.":::
 
 ### Display pictures for common words
 
-For commonly used terms, the Immersive Reader will display a picture.
+Immersive Reader displays pictures for commonly used terms.
 
-  ![Picture Dictionary with Immersive Reader](./media/picture-dictionary.png)
+:::image type="content" source="media/picture-dictionary.png" alt-text="Screenshot of Immersive Reader's picture dictionary displaying a picture of a tool for the word tool.":::
 
 ### Highlight parts of speech
 
-Immersive Reader can be use to help learners understand parts of speech and grammar by highlighting verbs, nouns, pronouns, and more.
+Immersive Reader can help learners understand parts of speech and grammar by highlighting verbs, nouns, pronouns, and more.
 
-  ![Show parts of speech with Immersive Reader](./media/parts-of-speech.png)
+:::image type="content" source="media/parts-of-speech.png" alt-text="Screenshot of Immersive Reader highlighting parts of speech using different colors.":::
 
 ### Read content aloud
 
-Speech synthesis (or text-to-speech) is baked into the Immersive Reader service, which lets your readers select text to be read aloud. 
+Speech synthesis, or text to speech, is baked into the Immersive Reader service. Readers can select text to be read aloud.
 
-  ![Read text aloud with Immersive Reader](./media/read-aloud.png)
+:::image type="content" source="media/read-aloud.png" alt-text="Screenshot of Immersive Reader's text-to-speech feature that reads text aloud.":::
 
 ### Translate content in real-time
 
-Immersive Reader can translate text into many languages in real-time. This is helpful to improve comprehension for readers learning a new language.
+Immersive Reader can translate text into many languages in real time, which helps to improve comprehension for readers learning a new language.
 
-  ![Translate text with Immersive Reader](./media/translation.png)
+:::image type="content" source="media/translation.png" alt-text="Screenshot of Immersive Reader's language translation feature.":::
 
 ### Split words into syllables
 
-With Immersive Reader you can break words into syllables to improve readability or to sound out new words.
+With Immersive Reader, you can break words into syllables to improve readability or to sound out new words.
 
-  ![Break words into syllables with Immersive Reader](./media/syllabification.png)
+:::image type="content" source="media/syllabification.png" alt-text="Screenshot of Immersive Reader breaking words into syllables.":::
 
 ## How does Immersive Reader work?
 
-Immersive Reader is a standalone web application. When invoked using the Immersive Reader client library is displayed on top of your existing web application in an `iframe`. When your web application calls the Immersive Reader service, you specify the content to show the reader. The Immersive Reader client library handles the creation and styling of the `iframe` and communication with the Immersive Reader backend service. The Immersive Reader service processes the content for parts of speech, text to speech, translation, and more.
+Immersive Reader is a standalone web application. When it's invoked, the Immersive Reader client library displays on top of your existing web application in an `iframe`. When your web application calls the Immersive Reader service, you specify the content to show the reader. The Immersive Reader client library handles the creation and styling of the `iframe` and communication with the Immersive Reader backend service. The Immersive Reader service processes the content for parts of speech, text to speech, translation, and more.
 
-## Get started with Immersive Reader
+## Next step
 
-The Immersive Reader client library is available in C#, JavaScript, Java (Android),  Kotlin (Android), and Swift (iOS). Get started with:
+The Immersive Reader client library is available in C#, JavaScript, Java (Android), Kotlin (Android), and Swift (iOS). Get started with:
 
 * [Quickstart: Use the Immersive Reader client library](quickstarts/client-libraries.md)