Skip to content

Commit 931ef2a

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into gqlu
2 parents e9ae4f2 + b6a897a commit 931ef2a

File tree

2,634 files changed

+27347
-19317
lines changed

Some content is hidden

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

2,634 files changed

+27347
-19317
lines changed

.openpublishing.publish.config.json

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -356,6 +356,12 @@
356356
"branch": "main",
357357
"branch_mapping": {}
358358
},
359+
{
360+
"path_to_root": "azure-functions-python-worker",
361+
"url": "https://github.com/Azure/azure-functions-python-worker",
362+
"branch": "dev",
363+
"branch_mapping": {}
364+
},
359365
{
360366
"path_to_root": "functions-openapi-turbine-repair",
361367
"url": "https://github.com/Azure-Samples/functions-openapi-turbine-repair",
@@ -866,6 +872,12 @@
866872
"branch": "master",
867873
"branch_mapping": {}
868874
},
875+
{
876+
"path_to_root": "blob-devguide-go",
877+
"url": "https://github.com/Azure-Samples/blob-storage-devguide-go",
878+
"branch": "main",
879+
"branch_mapping": {}
880+
},
869881
{
870882
"path_to_root": "azure-sdk-for-net",
871883
"url": "https://github.com/Azure/azure-sdk-for-net/",

.openpublishing.redirection.azure-kubernetes-service.json

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -351,12 +351,6 @@
351351
"redirect_url": "/cli/azure/aks#az_aks_create",
352352
"redirect_document_id": false
353353
},
354-
{
355-
"source_path_from_root": "/articles/aks/delete-cluster.md",
356-
"redirect_url": "/cli/azure/aks#az_aks_delete",
357-
"redirect_document_id": false
358-
},
359-
360354
{
361355
"source_path": "articles/aks/view-master-logs.md",
362356
"redirect_url": "/azure/aks/view-control-plane-logs",

.openpublishing.redirection.azure-monitor.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,11 @@
55
"redirect_url": "/azure/azure-monitor/snapshot-debugger/snapshot-debugger#release-notes-for-microsoftapplicationinsightssnapshotcollector",
66
"redirect_document_id": false
77
},
8+
{
9+
"source_path_from_root": "/articles/azure-monitor/agents/om-agents.md",
10+
"redirect_url": "/azure/azure-monitor/vm/scom-managed-instance-overview",
11+
"redirect_document_id": false
12+
},
813
{
914
"source_path_from_root": "/articles/azure-monitor/best-practices.md",
1015
"redirect_url": "/azure/azure-monitor/getting-started",

.openpublishing.redirection.defender-for-cloud.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path_from_root": "/articles/defender-for-cloud/secret-scanning.md",
5+
"redirect_url": "/azure/defender-for-cloud/secrets-scanning-servers",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path_from_root": "/articles/defender-for-cloud/prevent-misconfigurations.md",
510
"redirect_url": "/azure/defender-for-cloud/manage-mcsb",

.openpublishing.redirection.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/germany/index.yml",
5+
"redirect_url": "/previous-versions/azure/germany/index",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path_from_root": "/articles/internet-analyzer/internet-analyzer-cli.md",
510
"redirect_url": "/previous-versions/azure/internet-analyzer/internet-analyzer-cli",
@@ -3987,7 +3992,7 @@
39873992
},
39883993
{
39893994
"source_path_from_root":"/articles/trusted-signing/concept.md",
3990-
"redirect_url":"/azure/trusted-signing/concept-trustedsigning-resources-roles",
3995+
"redirect_url":"/azure/trusted-signing/concept-trusted-signing-resources-roles",
39913996
"redirect_document_id":false
39923997
},
39933998
{

.openpublishing.redirection.sentinel.json

Lines changed: 433 additions & 13 deletions
Large diffs are not rendered by default.

articles/ai-services/LUIS/app-schema-definition.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -30,12 +30,12 @@ When you import and export the app, choose either `.json` or `.lu`.
3030

3131
* Moving to version 7.x, the entities are represented as nested machine-learning entities.
3232
* Support for authoring nested machine-learning entities with `enableNestedChildren` property on the following authoring APIs:
33-
* [Add label](https://westus.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/5890b47c39e2bb052c5b9c08)
34-
* [Add batch label](https://westus.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/5890b47c39e2bb052c5b9c09)
35-
* [Review labels](https://westus.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/5890b47c39e2bb052c5b9c0a)
36-
* [Suggest endpoint queries for entities](https://westus.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/5890b47c39e2bb052c5b9c2e)
37-
* [Suggest endpoint queries for intents](https://westus.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview/operations/5890b47c39e2bb052c5b9c2d)
38-
33+
* Add label
34+
* Add batch label
35+
* Review labels
36+
* Suggest endpoint queries for entities
37+
* Suggest endpoint queries for intents
38+
For more information, see the [LUIS reference documentation](/rest/api/cognitiveservices-luis/authoring/features?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true).
3939
```json
4040
{
4141
"luis_schema_version": "7.0.0",

articles/ai-services/LUIS/concepts/utterances.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -33,17 +33,17 @@ When you start [adding example utterances](../how-to/entities.md) to your LUIS
3333

3434
## Utterances aren't always well formed
3535

36-
Your app may need to process sentences, like "Book a ticket to Paris for me", or a fragment of a sentence, like "Booking" or "Paris flight" Users also often make spelling mistakes. When planning your app, consider whether or not you want to use [Bing Spell Check](../luis-tutorial-bing-spellcheck.md) to correct user input before passing it to LUIS.
36+
Your app might need to process sentences, like "Book a ticket to Paris for me," or a fragment of a sentence, like "Booking" or "Paris flight" Users also often make spelling mistakes. When planning your app, consider whether or not you want to use [Bing Spell Check](../luis-tutorial-bing-spellcheck.md) to correct user input before passing it to LUIS.
3737

38-
If you do not spell check user utterances, you should train LUIS on utterances that include typos and misspellings.
38+
If you don't spell check user utterances, you should train LUIS on utterances that include typos and misspellings.
3939

4040
### Use the representative language of the user
4141

42-
When choosing utterances, be aware that what you think are common terms or phrases might not be common for the typical user of your client application. They may not have domain experience or use different terminology. Be careful when using terms or phrases that a user would only say if they were an expert.
42+
When choosing utterances, be aware that what you think are common terms or phrases might not be common for the typical user of your client application. They might not have domain experience or use different terminology. Be careful when using terms or phrases that a user would only say if they were an expert.
4343

4444
### Choose varied terminology and phrasing
4545

46-
You will find that even if you make efforts to create varied sentence patterns, you will still repeat some vocabulary. For example, the following utterances have similar meaning, but different terminology and phrasing:
46+
You'll find that even if you make efforts to create varied sentence patterns, you'll still repeat some vocabulary. For example, the following utterances have similar meaning, but different terminology and phrasing:
4747

4848
* "*How do I get a computer?*"
4949
* "*Where do I get a computer?*"
@@ -54,15 +54,15 @@ The core term here, _computer_, isn't varied. Use alternatives such as desktop c
5454

5555
## Example utterances in each intent
5656

57-
Each intent needs to have example utterances - at least 15. If you have an intent that does not have any example utterances, you will not be able to train LUIS. If you have an intent with one or few example utterances, LUIS may not accurately predict the intent.
57+
Each intent needs to have example utterances - at least 15. If you have an intent that doesn't have any example utterances, you will not be able to train LUIS. If you have an intent with one or few example utterances, LUIS might not accurately predict the intent.
5858

5959
## Add small groups of utterances
6060

6161
Each time you iterate on your model to improve it, don't add large quantities of utterances. Consider adding utterances in quantities of 15. Then [Train](../how-to/train-test.md), [publish](../how-to/publish.md), and [test](../how-to/train-test.md) again.
6262

6363
LUIS builds effective models with utterances that are carefully selected by the LUIS model author. Adding too many utterances isn't valuable because it introduces confusion.
6464

65-
It is better to start with a few utterances, then [review the endpoint utterances](../how-to/improve-application.md) for correct intent prediction and entity extraction.
65+
It's better to start with a few utterances, then [review the endpoint utterances](../how-to/improve-application.md) for correct intent prediction and entity extraction.
6666

6767
## Utterance normalization
6868

@@ -78,7 +78,7 @@ If you turn on a normalization setting, scores in the **Test** pane, batch tes
7878

7979
When you clone a version in the LUIS portal, the version settings are kept in the new cloned version.
8080

81-
Set your app's version settings using the LUIS portal by selecting **Manage** from the top navigation menu, in the **Application Settings** page. You can also use the [Update Version Settings API](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/versions-update-application-version-settings). See the [Reference](../luis-reference-application-settings.md) documentation for more information.
81+
Set your app's version settings using the LUIS portal by selecting **Manage** from the top navigation menu, in the **Application Settings** page. You can also use the [Update Version Settings API](/rest/api/cognitiveservices-luis/authoring/versions/update?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true). See the [Reference](../luis-reference-application-settings.md) documentation for more information.
8282

8383
## Word forms
8484

@@ -94,9 +94,9 @@ Diacritics are marks or signs within the text, such as:
9494

9595
Normalizing **punctuation** means that before your models get trained and before your endpoint queries get predicted, punctuation will be removed from the utterances.
9696

97-
Punctuation is a separate token in LUIS. An utterance that contains a period at the end is a separate utterance than one that does not contain a period at the end, and may get two different predictions.
97+
Punctuation is a separate token in LUIS. An utterance that contains a period at the end is a separate utterance than one that doesn't contain a period at the end, and might get two different predictions.
9898

99-
If punctuation is not normalized, LUIS doesn't ignore punctuation marks by default because some client applications may place significance on these marks. Make sure to include example utterances that use punctuation, and ones that don't, for both styles to return the same relative scores.
99+
If punctuation isn't normalized, LUIS doesn't ignore punctuation marks by default because some client applications might place significance on these marks. Make sure to include example utterances that use punctuation, and ones that don't, for both styles to return the same relative scores.
100100

101101
Make sure the model handles punctuation either in the example utterances (both having and not having punctuation) or in [patterns](../concepts/patterns-features.md) where it is easier to ignore punctuation. For example: I am applying for the {Job} position[.]
102102

@@ -108,11 +108,11 @@ If you want to ignore specific words or punctuation in patterns, use a [pattern]
108108

109109
## Training with all utterances
110110

111-
Training is generally non-deterministic: utterance prediction can vary slightly across versions or apps. You can remove non-deterministic training by updating the [version settings](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/versions-update-application-version-settings) API with the UseAllTrainingData name/value pair to use all training data.
111+
Training is nondeterministic: utterance prediction can vary slightly across versions or apps. You can remove nondeterministic training by updating the [version settings](/rest/api/cognitiveservices-luis/authoring/settings/update?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true) API with the UseAllTrainingData name/value pair to use all training data.
112112

113113
## Testing utterances
114114

115-
Developers should start testing their LUIS application with real data by sending utterances to the [prediction endpoint](../luis-how-to-azure-subscription.md) URL. These utterances are used to improve the performance of the intents and entities with [Review utterances](../how-to/improve-application.md). Tests submitted using the testing pane in the LUIS portal are not sent through the endpoint, and don't contribute to active learning.
115+
Developers should start testing their LUIS application with real data by sending utterances to the [prediction endpoint](../luis-how-to-azure-subscription.md) URL. These utterances are used to improve the performance of the intents and entities with [Review utterances](../how-to/improve-application.md). Tests submitted using the testing pane in the LUIS portal aren't sent through the endpoint, and don't contribute to active learning.
116116

117117
## Review utterances
118118

@@ -122,10 +122,10 @@ After your model is trained, published, and receiving [endpoint](../luis-glossar
122122

123123
### Label for word meaning
124124

125-
If the word choice or word arrangement is the same, but doesn't mean the same thing, do not label it with the entity.
125+
If the word choice or word arrangement is the same, but doesn't mean the same thing, don't label it with the entity.
126126

127127
In the following utterances, the word fair is a homograph, which means it's spelled the same but has a different meaning:
128-
* "*What kind of county fairs are happening in the Seattle area this summer?*"
128+
* "*What kinds of county fairs are happening in the Seattle area this summer?*"
129129
* "*Is the current 2-star rating for the restaurant fair?*
130130

131131
If you want an event entity to find all event data, label the word fair in the first utterance, but not in the second.
@@ -138,7 +138,7 @@ LUIS expects variations in an intent's utterances. The utterances can vary while
138138
| Don't use the same format | Do use varying formats |
139139
|--|--|
140140
| Buy a ticket to Seattle|Buy 1 ticket to Seattle|
141-
|Buy a ticket to Paris|Reserve two seats on the red eye to Paris next Monday|
141+
|Buy a ticket to Paris|Reserve two tickets on the red eye to Paris next Monday|
142142
|Buy a ticket to Orlando |I would like to book 3 tickets to Orlando for spring break |
143143

144144

articles/ai-services/LUIS/developer-reference-resource.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,8 +50,8 @@ Both authoring and prediction endpoint APIS are available from REST APIs:
5050

5151
|Type|Version|
5252
|--|--|
53-
|Authoring|[V2](https://go.microsoft.com/fwlink/?linkid=2092087)<br>[preview V3](https://westeurope.dev.cognitive.microsoft.com/docs/services/luis-programmatic-apis-v3-0-preview)|
54-
|Prediction|[V2](https://go.microsoft.com/fwlink/?linkid=2092356)<br>[V3](https://westcentralus.dev.cognitive.microsoft.com/docs/services/luis-endpoint-api-v3-0/)|
53+
|Authoring|[V2](https://go.microsoft.com/fwlink/?linkid=2092087)<br>[preview V3](/rest/api/cognitiveservices-luis/authoring/operation-groups)|
54+
|Prediction|[V2](https://go.microsoft.com/fwlink/?linkid=2092356)<br>[V3](/rest/api/cognitiveservices-luis/runtime/operation-groups?view=rest-cognitiveservices-luis-authoring-v3.0-preview&tabs=HTTP&preserve-view=true)|
5555

5656
### REST Endpoints
5757

0 commit comments

Comments
 (0)