Skip to content

Commit 6dd719c

Browse files
authored
Switch from dotnet verb noun to dotnet noun verb (#43917)
1 parent 3961e3c commit 6dd719c

File tree

72 files changed

+458
-414
lines changed

Some content is hidden

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

72 files changed

+458
-414
lines changed

.openpublishing.redirection.core.json

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -878,12 +878,12 @@
878878
},
879879
{
880880
"source_path_from_root": "/docs/core/preview3/tools/dotnet-add-package.md",
881-
"redirect_url": "/dotnet/core/tools/dotnet-add-package",
881+
"redirect_url": "/dotnet/core/tools/dotnet-package-add",
882882
"redirect_document_id": true
883883
},
884884
{
885885
"source_path_from_root": "/docs/core/preview3/tools/dotnet-add-reference.md",
886-
"redirect_url": "/dotnet/core/tools/dotnet-add-reference",
886+
"redirect_url": "/dotnet/core/tools/dotnet-reference-add",
887887
"redirect_document_id": true
888888
},
889889
{
@@ -901,7 +901,7 @@
901901
},
902902
{
903903
"source_path_from_root": "/docs/core/preview3/tools/dotnet-list-reference.md",
904-
"redirect_url": "/dotnet/core/tools/dotnet-list-reference",
904+
"redirect_url": "/dotnet/core/tools/dotnet-reference-list",
905905
"redirect_document_id": true
906906
},
907907
{
@@ -943,12 +943,12 @@
943943
},
944944
{
945945
"source_path_from_root": "/docs/core/preview3/tools/dotnet-remove-package.md",
946-
"redirect_url": "/dotnet/core/tools/dotnet-remove-package",
946+
"redirect_url": "/dotnet/core/tools/dotnet-package-remove",
947947
"redirect_document_id": true
948948
},
949949
{
950950
"source_path_from_root": "/docs/core/preview3/tools/dotnet-remove-reference.md",
951-
"redirect_url": "/dotnet/core/tools/dotnet-remove-reference",
951+
"redirect_url": "/dotnet/core/tools/dotnet-reference-remove",
952952
"redirect_document_id": true
953953
},
954954
{
@@ -1151,6 +1151,30 @@
11511151
"source_path_from_root": "/docs/core/tools/csproj.md",
11521152
"redirect_url": "/dotnet/core/project-sdk/msbuild-props"
11531153
},
1154+
{
1155+
"source_path_from_root": "/docs/core/tools/dotnet-add-package.md",
1156+
"redirect_url": "/dotnet/core/tools/dotnet-package-add"
1157+
},
1158+
{
1159+
"source_path_from_root": "/docs/core/tools/dotnet-list-package.md",
1160+
"redirect_url": "/dotnet/core/tools/dotnet-package-list"
1161+
},
1162+
{
1163+
"source_path_from_root": "/docs/core/tools/dotnet-remove-package.md",
1164+
"redirect_url": "/dotnet/core/tools/dotnet-package-remove"
1165+
},
1166+
{
1167+
"source_path_from_root": "/docs/core/tools/dotnet-add-reference.md",
1168+
"redirect_url": "/dotnet/core/tools/dotnet-reference-add"
1169+
},
1170+
{
1171+
"source_path_from_root": "/docs/core/tools/dotnet-list-reference.md",
1172+
"redirect_url": "/dotnet/core/tools/dotnet-reference-list"
1173+
},
1174+
{
1175+
"source_path_from_root": "/docs/core/tools/dotnet-remove-reference.md",
1176+
"redirect_url": "/dotnet/core/tools/dotnet-reference-remove"
1177+
},
11541178
{
11551179
"source_path_from_root": "/docs/core/tools/extensibility.md",
11561180
"redirect_url": "/dotnet/core/project-sdk/overview"

docs/ai/how-to/app-service-aoai-auth.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -153,11 +153,11 @@ az role assignment create --assignee "<managedIdentityObjectID>" \
153153
1. Add the following NuGet packages to your app:
154154

155155
```dotnetcli
156-
dotnet add package Azure.Identity
157-
dotnet add package Azure.AI.OpenAI
158-
dotnet add package Microsoft.Extensions.Azure
159-
dotnet add package Microsoft.Extensions.AI
160-
dotnet add package Microsoft.Extensions.AI.OpenAI
156+
dotnet package add Azure.Identity
157+
dotnet package add Azure.AI.OpenAI
158+
dotnet package add Microsoft.Extensions.Azure
159+
dotnet package add Microsoft.Extensions.AI
160+
dotnet package add Microsoft.Extensions.AI.OpenAI
161161
```
162162
163163
The preceding packages each handle the following concerns for this scenario:

docs/ai/how-to/content-filtering.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ To use the sample code in this article, you need to create and assign a content
3232
1. Add the [`Azure.AI.OpenAI`](https://www.nuget.org/packages/Azure.AI.OpenAI) NuGet package to your project.
3333

3434
```dotnetcli
35-
dotnet add package Azure.AI.OpenAI
35+
dotnet package add Azure.AI.OpenAI
3636
```
3737
3838
1. Create a simple chat completion flow in your .NET app using the `AzureOpenAiClient`. Replace the `YOUR_MODEL_ENDPOINT` and `YOUR_MODEL_DEPLOYMENT_NAME` values with your own.
@@ -49,4 +49,4 @@ The response was filtered due to the prompt triggering Azure OpenAI's content ma
4949

5050
* [Create and assign a content filter](/azure/ai-services/openai/how-to/content-filters)
5151
* [Content Filtering concepts](/azure/ai-services/openai/concepts/content-filter)
52-
* [Create a chat app](/dotnet/ai/quickstarts/prompt-model)
52+
* [Create a chat app](../quickstarts/prompt-model.md)

docs/ai/quickstarts/build-chat-app.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -54,22 +54,22 @@ Complete the following steps to create a .NET console app to connect to an AI mo
5454
:::zone target="docs" pivot="azure-openai"
5555
5656
```bash
57-
dotnet add package Azure.Identity
58-
dotnet add package Azure.AI.OpenAI
59-
dotnet add package Microsoft.Extensions.AI.OpenAI
60-
dotnet add package Microsoft.Extensions.Configuration
61-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
57+
dotnet package add Azure.Identity
58+
dotnet package add Azure.AI.OpenAI
59+
dotnet package add Microsoft.Extensions.AI.OpenAI
60+
dotnet package add Microsoft.Extensions.Configuration
61+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
6262
```
6363
6464
:::zone-end
6565
6666
:::zone target="docs" pivot="openai"
6767
6868
```bash
69-
dotnet add package OpenAI
70-
dotnet add package Microsoft.Extensions.AI.OpenAI
71-
dotnet add package Microsoft.Extensions.Configuration
72-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
69+
dotnet package add OpenAI
70+
dotnet package add Microsoft.Extensions.AI.OpenAI
71+
dotnet package add Microsoft.Extensions.Configuration
72+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
7373
```
7474
7575
:::zone-end
@@ -153,5 +153,5 @@ azd down
153153

154154
## Next steps
155155

156-
- [Quickstart - Chat with a local AI model](/dotnet/ai/quickstarts/chat-local-model)
157-
- [Generate images using AI with .NET](/dotnet/ai/quickstarts/generate-images)
156+
- [Quickstart - Chat with a local AI model](chat-local-model.md)
157+
- [Generate images using AI with .NET](generate-images.md)

docs/ai/quickstarts/build-vector-search-app.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -70,13 +70,13 @@ Complete the following steps to create a .NET console app that can:
7070
:::zone target="docs" pivot="azure-openai"
7171
7272
```bash
73-
dotnet add package Azure.Identity
74-
dotnet add package Azure.AI.OpenAI
75-
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
76-
dotnet add package Microsoft.Extensions.VectorData.Abstractions --prerelease
77-
dotnet add package Microsoft.SemanticKernel.Connectors.InMemory --prerelease
78-
dotnet add package Microsoft.Extensions.Configuration
79-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
73+
dotnet package add Azure.Identity
74+
dotnet package add Azure.AI.OpenAI
75+
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
76+
dotnet package add Microsoft.Extensions.VectorData.Abstractions --prerelease
77+
dotnet package add Microsoft.SemanticKernel.Connectors.InMemory --prerelease
78+
dotnet package add Microsoft.Extensions.Configuration
79+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
8080
```
8181
8282
The following list describes what each package is used for in the `VectorDataAI` app:
@@ -93,11 +93,11 @@ Complete the following steps to create a .NET console app that can:
9393
:::zone target="docs" pivot="openai"
9494
9595
```bash
96-
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
97-
dotnet add package Microsoft.Extensions.VectorData.Abstractions --prerelease
98-
dotnet add package Microsoft.SemanticKernel.Connectors.InMemory --prerelease
99-
dotnet add package Microsoft.Extensions.Configuration
100-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
96+
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
97+
dotnet package add Microsoft.Extensions.VectorData.Abstractions --prerelease
98+
dotnet package add Microsoft.SemanticKernel.Connectors.InMemory --prerelease
99+
dotnet package add Microsoft.Extensions.Configuration
100+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
101101
```
102102
103103
The following list describes what each package is used for in the `VectorDataAI` app:
@@ -205,5 +205,5 @@ azd down
205205

206206
## Next steps
207207

208-
- [Quickstart - Chat with a local AI model](/dotnet/ai/quickstarts/chat-local-model)
209-
- [Generate images using AI with .NET](/dotnet/ai/quickstarts/generate-images)
208+
- [Quickstart - Chat with a local AI model](chat-local-model.md)
209+
- [Generate images using AI with .NET](generate-images.md)

docs/ai/quickstarts/chat-local-model.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ Complete the following steps to create a .NET console app that connects to your
6565
1. Add the [Microsoft.Extensions.AI.Ollama](https://aka.ms/meai-ollama-nuget) packages to your app:
6666

6767
```dotnetcli
68-
dotnet add package Microsoft.Extensions.AI.Ollama --prerelease
68+
dotnet package add Microsoft.Extensions.AI.Ollama --prerelease
6969
```
7070

7171
1. Open the new app in your editor of choice, such as Visual Studio Code.

docs/ai/quickstarts/create-assistant.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ Complete the following steps to create a .NET console app and add the package ne
7272
1. Add the [OpenAI](https://www.nuget.org/packages/OpenAI) package to your app:
7373
7474
```dotnetcli
75-
dotnet add package OpenAI --prerelease
75+
dotnet package add OpenAI --prerelease
7676
```
7777
7878
1. Open the new app in your editor of choice, such as Visual Studio Code.
@@ -94,7 +94,7 @@ Complete the following steps to create a .NET console app and add the package ne
9494
1. Add the [Azure.AI.OpenAI](https://www.nuget.org/packages/Azure.AI.OpenAI) package to your app:
9595
9696
```dotnetcli
97-
dotnet add package Azure.AI.OpenAI --prerelease
97+
dotnet package add Azure.AI.OpenAI --prerelease
9898
```
9999
100100
1. Open the new app in your editor of choice, such as Visual Studio Code.

docs/ai/quickstarts/evaluate-ai-response.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -35,14 +35,14 @@ Complete the following steps to create an MSTest project that connects to your l
3535
1. Navigate to the `TestAI` directory, and add the necessary packages to your app:
3636
3737
```dotnetcli
38-
dotnet add package Azure.AI.OpenAI
39-
dotnet add package Azure.Identity
40-
dotnet add package Microsoft.Extensions.AI.Abstractions --prerelease
41-
dotnet add package Microsoft.Extensions.AI.Evaluation --prerelease
42-
dotnet add package Microsoft.Extensions.AI.Evaluation.Quality --prerelease
43-
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
44-
dotnet add package Microsoft.Extensions.Configuration
45-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
38+
dotnet package add Azure.AI.OpenAI
39+
dotnet package add Azure.Identity
40+
dotnet package add Microsoft.Extensions.AI.Abstractions --prerelease
41+
dotnet package add Microsoft.Extensions.AI.Evaluation --prerelease
42+
dotnet package add Microsoft.Extensions.AI.Evaluation.Quality --prerelease
43+
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
44+
dotnet package add Microsoft.Extensions.Configuration
45+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
4646
```
4747
4848
1. Run the following commands to add [app secrets](/aspnet/core/security/app-secrets) for your Azure OpenAI endpoint, model name, and tenant ID:

docs/ai/quickstarts/generate-images.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -51,19 +51,19 @@ Complete the following steps to create a .NET console app to connect to an AI mo
5151
:::zone target="docs" pivot="azure-openai"
5252
5353
```bash
54-
dotnet add package Azure.AI.OpenAI
55-
dotnet add package Microsoft.Extensions.Configuration
56-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
54+
dotnet package add Azure.AI.OpenAI
55+
dotnet package add Microsoft.Extensions.Configuration
56+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
5757
```
5858
5959
:::zone-end
6060
6161
:::zone target="docs" pivot="openai"
6262
6363
```bash
64-
dotnet add package OpenAI
65-
dotnet add package Microsoft.Extensions.Configuration
66-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
64+
dotnet package add OpenAI
65+
dotnet package add Microsoft.Extensions.Configuration
66+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
6767
```
6868
6969
:::zone-end
@@ -105,7 +105,7 @@ Complete the following steps to create a .NET console app to connect to an AI mo
105105
:::code language="csharp" source="snippets/image-generation/azure-openai/program.cs" :::
106106
107107
> [!NOTE]
108-
> <xref:Azure.Identity.DefaultAzureCredential> searches for authentication credentials from your local tooling. If you aren't using the `azd` template to provision the Azure OpenAI resource, you'll need to assign the `Azure AI Developer` role to the account you used to sign-in to Visual Studio or the Azure CLI. For more information, see [Authenticate to Azure AI services with .NET](/dotnet/ai/azure-ai-services-authentication).
108+
> <xref:Azure.Identity.DefaultAzureCredential> searches for authentication credentials from your local tooling. If you aren't using the `azd` template to provision the Azure OpenAI resource, you'll need to assign the `Azure AI Developer` role to the account you used to sign-in to Visual Studio or the Azure CLI. For more information, see [Authenticate to Azure AI services with .NET](../azure-ai-services-authentication.md).
109109
110110
:::zone-end
111111
@@ -144,5 +144,5 @@ azd down
144144

145145
## Next steps
146146

147-
- [Quickstart - Build an AI chat app with .NET](/dotnet/ai/quickstarts/build-chat-app)
147+
- [Quickstart - Build an AI chat app with .NET](build-chat-app.md)
148148
- [Generate text and conversations with .NET and Azure OpenAI Completions](/training/modules/open-ai-dotnet-text-completions/)

docs/ai/quickstarts/prompt-model.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -54,22 +54,22 @@ Complete the following steps to create a .NET console app to connect to an AI mo
5454
:::zone target="docs" pivot="azure-openai"
5555
5656
```bash
57-
dotnet add package Azure.Identity
58-
dotnet add package Azure.AI.OpenAI
59-
dotnet add package Microsoft.Extensions.AI.OpenAI
60-
dotnet add package Microsoft.Extensions.Configuration
61-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
57+
dotnet package add Azure.Identity
58+
dotnet package add Azure.AI.OpenAI
59+
dotnet package add Microsoft.Extensions.AI.OpenAI
60+
dotnet package add Microsoft.Extensions.Configuration
61+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
6262
```
6363
6464
:::zone-end
6565
6666
:::zone target="docs" pivot="openai"
6767
6868
```bash
69-
dotnet add package OpenAI
70-
dotnet add package Microsoft.Extensions.AI.OpenAI
71-
dotnet add package Microsoft.Extensions.Configuration
72-
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
69+
dotnet package add OpenAI
70+
dotnet package add Microsoft.Extensions.AI.OpenAI
71+
dotnet package add Microsoft.Extensions.Configuration
72+
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
7373
```
7474
7575
:::zone-end
@@ -113,7 +113,7 @@ The app uses the [`Microsoft.Extensions.AI`](https://www.nuget.org/packages/Micr
113113
:::code language="csharp" source="snippets/prompt-completion/azure-openai/program.cs" range="1-12":::
114114
115115
> [!NOTE]
116-
> <xref:Azure.Identity.DefaultAzureCredential> searches for authentication credentials from your local tooling. If you aren't using the `azd` template to provision the Azure OpenAI resource, you'll need to assign the `Azure AI Developer` role to the account you used to sign-in to Visual Studio or the Azure CLI. For more information, see [Authenticate to Azure AI services with .NET](/dotnet/ai/azure-ai-services-authentication).
116+
> <xref:Azure.Identity.DefaultAzureCredential> searches for authentication credentials from your local tooling. If you aren't using the `azd` template to provision the Azure OpenAI resource, you'll need to assign the `Azure AI Developer` role to the account you used to sign-in to Visual Studio or the Azure CLI. For more information, see [Authenticate to Azure AI services with .NET](../azure-ai-services-authentication.md).
117117
118118
:::zone-end
119119
@@ -153,5 +153,5 @@ azd down
153153

154154
## Next steps
155155

156-
- [Quickstart - Build an AI chat app with .NET](/dotnet/ai/quickstarts/build-chat-app)
156+
- [Quickstart - Build an AI chat app with .NET](build-chat-app.md)
157157
- [Generate text and conversations with .NET and Azure OpenAI Completions](/training/modules/open-ai-dotnet-text-completions/)

0 commit comments

Comments
 (0)