Skip to content

Commit 141168f

Browse files
committed
fix to wording
1 parent 5b24790 commit 141168f

File tree

571 files changed

+2922
-1788
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

571 files changed

+2922
-1788
lines changed

articles/active-directory-b2c/faq.yml

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -274,6 +274,12 @@ sections:
274274
275275
* API connectors
276276
* Conditional Access
277+
278+
- question: |
279+
I am using rolling refresh tokens for my application and I am getting an invalid_grant error on redeeming newly acquired refresh tokens well within their set validity period. Why does this happen?
280+
answer: |
281+
While determining validity for rolling refresh tokens, B2C will consider the initial login time of the user in the application also to calculate the token validity skew. If the user haven't logged out of the application for a very long time, this skew value will exceed the validity period of the token and hence for security reasons the tokens will be considered as invalid. Hence the error. Inform the user to perform a proper logout and login back into the application and this should reset the skew. This scenario is not applicable if refresh token rolling is set as infinite rolling.
282+
277283
278284
- question: |
279285
I've revoked the refresh token using Microsoft Graph invalidateAllRefreshTokens, or Microsoft Graph PowerShell, Revoke-MgUserSignInSession. Why is Azure AD B2C still accepting the old refresh token?
@@ -286,6 +292,9 @@ sections:
286292
1. Wait for 10 minutes.
287293
288294
1. Retrieve the `RefreshToken` again.
295+
296+
> [!TIP]
297+
> With Azure AD B2C [custom policy](custom-policy-overview.md), you can reduce the above mentioned skew time of 5 minutes (300000 milliseconds) by adjusting the value for InputParameter "TreatAsEqualIfWithinMillseconds" under claim transformation Id "AssertRefreshTokenIssuedLaterThanValidFromDate". This claim transformation can be found in the TrustFrameworkBase.xml file under latest custom policy [stater-pack](https://learn.microsoft.com/en-us/azure/active-directory-b2c/tutorial-create-user-flows?pivots=b2c-custom-policy#get-the-starter-pack).
289298
290299
- question: |
291300
I use multiple tabs in a web browser to sign in to multiple applications that I registered in the same Azure AD B2C tenant. When I try to perform a single sign-out, not all of the applications are signed out. Why does this happen?

articles/active-directory-b2c/javascript-and-page-layout.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ zone_pivot_groups: b2c-policy-type
2323

2424
[!INCLUDE [active-directory-b2c-choose-user-flow-or-custom-policy](../../includes/active-directory-b2c-choose-user-flow-or-custom-policy.md)]
2525

26-
With Azure Active Directory B2C (Azure AD B2C) [HTML templates](customize-ui-with-html.md), you can craft your users' identity experiences. Your HTML templates can contain only certain HTML tags and attributes. Basic HTML tags, such as &lt;b&gt;, &lt;i&gt;, &lt;u&gt;, &lt;h1&gt;, and &lt;hr&gt; are allowed. More advanced tags such as &lt;script&gt;, and &lt;iframe&gt; are removed for security reasons but the `<script>` tag should be added in the `<head>` tag.
26+
With Azure Active Directory B2C (Azure AD B2C) [HTML templates](customize-ui-with-html.md), you can craft your users' identity experiences. Your HTML templates can contain only certain HTML tags and attributes. Basic HTML tags, such as &lt;b&gt;, &lt;i&gt;, &lt;u&gt;, &lt;h1&gt;, and &lt;hr&gt; are allowed. More advanced tags such as &lt;script&gt;, and &lt;iframe&gt; are removed for security reasons but the `<script>` tag should be added in the `<head>` tag. From selfasserted page layout version 2.1.21 / unifiedssp version 2.1.10 / multifactor version 1.2.10 onwards B2C doesn't support adding scripts in `<body>` tag (as this can pose a risk for cross site scripting attack). Migrating existing scripts from `<body>` to `<head>` may at-times require rewriting existing scripts with mutation observers for proper working.
2727

2828
The `<script>` tag should be added in the `<head>` tag in two ways:
2929

articles/ai-services/computer-vision/concept-model-customization.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -80,8 +80,8 @@ The following table describes the limits on the scale of your custom model proje
8080
| Max # training images | 1,000,000 | 200,000 |
8181
| Max # evaluation images | 100,000 | 100,000 |
8282
| Min # training images per category | 2 | 2 |
83-
| Max # tags per image | multiclass: 1 | NA |
84-
| Max # regions per image | NA | 1,000 |
83+
| Max # tags per image | 1 | N/A |
84+
| Max # regions per image | N/A | 1,000 |
8585
| Max # categories | 2,500 | 1,000 |
8686
| Min # categories | 2 | 1 |
8787
| Max image size (Training) | 20 MB | 20 MB |

articles/ai-services/content-safety/overview.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,8 @@ This documentation contains the following article types:
3030

3131
The following are a few scenarios in which a software developer or team would require a content moderation service:
3232

33+
- User prompts submitted to a generative AI service.
34+
- Content produced by generative AI models.
3335
- Online marketplaces that moderate product catalogs and other user-generated content.
3436
- Gaming companies that moderate user-generated game artifacts and chat rooms.
3537
- Social messaging platforms that moderate images and text added by their users.

articles/ai-services/language-service/conversational-language-understanding/glossary.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ A model is an object that's trained to do a certain task, in this case conversat
3838

3939
## Overfitting
4040

41-
Overfitting happens when the model is fixated on the specific examples and is not able to generalize well.
41+
Overfitting happens when the model is fixated on the specific examples and isn't able to generalize well.
4242

4343
## Precision
4444
Measures how precise/accurate your model is. It's the ratio between the correctly identified positives (true positives) and all identified positives. The precision metric reveals how many of the predicted classes are correctly labeled.
@@ -53,14 +53,14 @@ Measures the model's ability to predict actual positive classes. It's the ratio
5353
A regular expression entity represents a regular expression. Regular expression entities are exact matches.
5454

5555
## Schema
56-
Schema is defined as the combination of intents and entities within your project. Schema design is a crucial part of your project's success. When creating a schema, you want think about which intents and entities should be included in your project
56+
Schema is defined as the combination of intents and entities within your project. Schema design is a crucial part of your project's success. When creating a schema, you want to think about which intents and entities should be included in your project.
5757

5858
## Training data
5959
Training data is the set of information that is needed to train a model.
6060

6161
## Utterance
6262

63-
An utterance is user input that is short text representative of a sentence in a conversation. It is a natural language phrase such as "book 2 tickets to Seattle next Tuesday". Example utterances are added to train the model and the model predicts on new utterance at runtime
63+
An utterance is user input that is short text representative of a sentence in a conversation. It's a natural language phrase such as "book 2 tickets to Seattle next Tuesday". Example utterances are added to train the model and the model predicts on new utterance at runtime
6464

6565

6666
## Next steps

articles/ai-services/language-service/question-answering/how-to/migrate-qnamaker-to-question-answering.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.topic: how-to
99
ms.date: 12/19/2023
1010
ms.custom: language-service-question-answering
1111
---
12-
# Migrate from QnA Maker to custom question qnswering
12+
# Migrate from QnA Maker to custom question answering
1313

1414
**Purpose of this document:** This article aims to provide information that can be used to successfully migrate applications that use QnA Maker to custom question answering. Using this article, we hope customers will gain clarity on the following:
1515

@@ -28,7 +28,7 @@ ms.custom: language-service-question-answering
2828
> - Automatic RBAC to Language project (not resource)
2929
> - Automatic enabling of analytics.
3030
31-
You will also need to [re-enable analytics](analytics.md) for the language resource.
31+
You'll also need to [re-enable analytics](analytics.md) for the language resource.
3232

3333
## Comparison of features
3434

@@ -42,7 +42,7 @@ In addition to a new set of features, custom question answering provides many te
4242
|Smart URL Refresh||✔️|Custom question answering provides a means to refresh ingested content from public sources with a single click.|
4343
|Q&A over knowledge base (hierarchical extraction)|✔️|✔️| |
4444
|Active learning|✔️|✔️|Custom question answering has an improved active learning model.|
45-
|Alternate Questions|✔️|✔️|The improved models in custom question answering reduces the need to add alternate questions.|
45+
|Alternate Questions|✔️|✔️|The improved models in custom question answering reduce the need to add alternate questions.|
4646
|Synonyms|✔️|✔️| |
4747
|Metadata|✔️|✔️| |
4848
|Question Generation (private preview)||✔️|This new feature will allow generation of questions over text.|
@@ -54,7 +54,7 @@ In addition to a new set of features, custom question answering provides many te
5454

5555
## Pricing
5656

57-
When you are looking at migrating to custom question answering, please consider the following:
57+
When you're looking at migrating to custom question answering, please consider the following:
5858

5959
|Component |QnA Maker|Custom question answering|Details |
6060
|-------------------------------|---------|------------------|---------------------------------------------------------------------------------------------------------|
@@ -65,7 +65,7 @@ When you are looking at migrating to custom question answering, please consider
6565

6666
- Users may select a higher tier with higher capacity, which will impact overall price they pay. It doesn’t impact the price on language component of custom question answering.
6767

68-
- “Text Records” in custom question answering features refers to the query submitted by the user to the runtime, and it is a concept common to all features within Language service. Sometimes a query may have more text records when the query length is higher.
68+
- “Text Records” in custom question answering features refers to the query submitted by the user to the runtime, and it's a concept common to all features within Language service. Sometimes a query may have more text records when the query length is higher.
6969

7070
**Example price estimations**
7171

@@ -76,7 +76,7 @@ When you are looking at migrating to custom question answering, please consider
7676
|Medium|10 |10(S1) |800K |4x3(S1) |Less expensive |
7777
|Low |4 |4(B1) |100K |3x3(S1) |Less expensive |
7878

79-
Summary : Customers should save cost across the most common configurations as seen in the relative cost column.
79+
Summary: Customers should save cost across the most common configurations as seen in the relative cost column.
8080

8181
Here you can find the pricing details for [custom question answering](https://azure.microsoft.com/pricing/details/cognitive-services/language-service/) and [QnA Maker](https://azure.microsoft.com/pricing/details/cognitive-services/qna-maker/).
8282

@@ -101,7 +101,7 @@ Following are the broad migration phases to consider:
101101

102102
![A chart showing the phases of a successful migration](../media/migrate-qnamaker-to-question-answering/migration-phases.png)
103103

104-
Additional links which can help you are given below:
104+
Additional links which can help you're given below:
105105
- [Authoring portal](https://language.cognitive.azure.com/home)
106106
- [API](authoring.md)
107107
- [SDK](/dotnet/api/microsoft.azure.cognitiveservices.knowledge.qnamaker)
@@ -115,7 +115,7 @@ This topic compares two hypothetical scenarios when migrating from QnA Maker to
115115
> An attempt has been made to ensure these scenarios are representative of real customer migrations, however, individual customer scenarios will of course differ. Also, this article doesn't include pricing details. Visit the [pricing](https://azure.microsoft.com/pricing/details/cognitive-services/language-service/) page for more information.
116116
117117
> [!IMPORTANT]
118-
> Each custom question answering project is equivalent to a knowledge base in QnA Maker. Resource level settings such as Role-based access control (RBAC) are not migrated to the new resource. These resource level settings would have to be reconfigured for the language resource post migration. You will also need to [re-enable analytics](analytics.md) for the language resource.
118+
> Each custom question answering project is equivalent to a knowledge base in QnA Maker. Resource level settings such as Role-based access control (RBAC) are not migrated to the new resource. These resource level settings would have to be reconfigured for the language resource post migration. You'll also need to [re-enable analytics](analytics.md) for the language resource.
119119
120120
### Migration scenario 1: No custom authoring portal
121121

articles/ai-services/language-service/question-answering/how-to/migrate-qnamaker.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.date: 12/19/2023
99
ms.custom: language-service-question-answering
1010
---
1111

12-
# Migrate from QnA Maker to custom question answering
12+
# Migrate from QnA Maker knowledge bases to custom question answering
1313

1414
> [!NOTE]
1515
> You can also migrate to [Azure OpenAI](../../../qnamaker/How-To/migrate-to-openai.md).
@@ -32,7 +32,7 @@ This [SDK Migration Guide](https://github.com/Azure/azure-sdk-for-net/blob/Azure
3232

3333
You can follow the steps below to migrate knowledge bases:
3434

35-
1. Create a [language resource](https://aka.ms/create-language-resource) with custom question answering enabled in advance. When you create the language resource in the Azure portal, you will see the option to enable custom question answering. When you select that option and proceed, you will be asked for Azure Search details to save the knowledge bases.
35+
1. Create a [language resource](https://aka.ms/create-language-resource) with custom question answering enabled in advance. When you create the language resource in the Azure portal, you'll see the option to enable custom question answering. When you select that option and proceed, you'll be asked for Azure Search details to save the knowledge bases.
3636

3737
2. If you want to add knowledge bases in multiple languages to your language resource, visit [Language Studio](https://language.azure.com/) to create your first custom question answering project and select the first option as shown below. Language settings for the language resource can be specified only when creating a project. If you want to migrate existing knowledge bases in a single language to the language resource, you can skip this step.
3838

@@ -53,12 +53,12 @@ You can follow the steps below to migrate knowledge bases:
5353
> [!div class="mx-imgBorder"]
5454
> ![Migrate QnAMaker with red selection box around the QnAMaker resource selection option](../media/migrate-qnamaker/select-resource.png)
5555
56-
6. Select the language resource to which you want to migrate the knowledge bases. You will only be able to see those language resources that have custom question answering enabled. The language setting for the language resource is displayed in the options. You won’t be able to migrate knowledge bases in multiple languages from QnA Maker resources to a language resource if its language setting is not specified.
56+
6. Select the language resource to which you want to migrate the knowledge bases. You'll only be able to see those language resources that have custom question answering enabled. The language setting for the language resource is displayed in the options. You won’t be able to migrate knowledge bases in multiple languages from QnA Maker resources to a language resource if its language setting isn't specified.
5757

5858
> [!div class="mx-imgBorder"]
5959
> ![Migrate QnAMaker with red selection box around the language resource option currently selected resource contains the information that language is unspecified](../media/migrate-qnamaker/language-setting.png)
6060
61-
If you want to migrate knowledge bases in multiple languages to the language resource, you must enable the multiple language setting when creating the first custom question answering project for the language resource. You can do so by following the instructions in step #2. **If the language setting for the language resource is not specified, it is assigned the language of the selected QnA Maker resource**.
61+
If you want to migrate knowledge bases in multiple languages to the language resource, you must enable the multiple language setting when creating the first custom question answering project for the language resource. You can do so by following the instructions in step #2. **If the language setting for the language resource isn't specified, it is assigned the language of the selected QnA Maker resource**.
6262

6363
7. Select all the knowledge bases that you wish to migrate > select **Next**.
6464

@@ -71,26 +71,26 @@ You can follow the steps below to migrate knowledge bases:
7171
> If you migrate a knowledge base with the same name as a project that already exists in the target language resource, **the content of the project will be overridden** by the content of the selected knowledge base.
7272
7373
> [!div class="mx-imgBorder"]
74-
> ![Screenshot of an error message starting project names can't contain special characters](../media/migrate-qnamaker/migration-kb-name-validation.png)
74+
> ![Screenshot of an error message starting project names can't contain special characters.](../media/migrate-qnamaker/migration-kb-name-validation.png)
7575
7676
9. After resolving the validation errors, select **Start migration**
7777

7878
> [!div class="mx-imgBorder"]
79-
> ![Screenshot with special characters removed](../media/migrate-qnamaker/migration-kb-name-validation-success.png)
79+
> ![Screenshot with special characters removed.](../media/migrate-qnamaker/migration-kb-name-validation-success.png)
8080
81-
10. It will take a few minutes for the migration to occur. Do not cancel the migration while it is in progress. You can navigate to the migrated projects within the [Language Studio](https://language.azure.com/) post migration.
81+
10. It will take a few minutes for the migration to occur. Don't cancel the migration while it is in progress. You can navigate to the migrated projects within the [Language Studio](https://language.azure.com/) post migration.
8282

8383
> [!div class="mx-imgBorder"]
84-
> ![Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio](../media/migrate-qnamaker/migration-success.png)
84+
> ![Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio.](../media/migrate-qnamaker/migration-success.png)
8585
8686
If any knowledge bases fail to migrate to custom question answering projects, an error will be displayed. The most common migration errors occur when:
8787

8888
- Your source and target resources are invalid.
89-
- You are trying to migrate an empty knowledge base (KB).
90-
- You have reached the limit for an Azure Search instance linked to your target resources.
89+
- You're trying to migrate an empty knowledge base (KB).
90+
- You've reached the limit for an Azure Search instance linked to your target resources.
9191

9292
> [!div class="mx-imgBorder"]
93-
> ![Screenshot of a failed migration with an example error](../media/migrate-qnamaker/migration-errors.png)
93+
> ![Screenshot of a failed migration with an example error.](../media/migrate-qnamaker/migration-errors.png)
9494
9595
Once you resolve these errors, you can rerun the migration.
9696

0 commit comments

Comments
 (0)