Skip to content

Revert to older verb-noun form for 'dotnet package add' in instructions #45670

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 9, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/ai/how-to/app-service-aoai-auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,11 +153,11 @@ az role assignment create --assignee "<managedIdentityObjectID>" \
1. Add the following NuGet packages to your app:

```dotnetcli
dotnet package add Azure.Identity
dotnet package add Azure.AI.OpenAI
dotnet package add Microsoft.Extensions.Azure
dotnet package add Microsoft.Extensions.AI
dotnet package add Microsoft.Extensions.AI.OpenAI
dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.Azure
dotnet add package Microsoft.Extensions.AI
dotnet add package Microsoft.Extensions.AI.OpenAI
```

The preceding packages each handle the following concerns for this scenario:
Expand Down
12 changes: 9 additions & 3 deletions docs/ai/how-to/content-filtering.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,9 +31,15 @@ To use the sample code in this article, you need to create and assign a content

1. Add the [`Azure.AI.OpenAI`](https://www.nuget.org/packages/Azure.AI.OpenAI) NuGet package to your project.

```dotnetcli
dotnet package add Azure.AI.OpenAI
```
```dotnetcli
dotnet add package Azure.AI.OpenAI
```

Or, in .NET 10+:

```dotnetcli
dotnet package add Azure.AI.OpenAI
```

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.

Expand Down
18 changes: 9 additions & 9 deletions docs/ai/quickstarts/build-chat-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,22 +54,22 @@ Complete the following steps to create a .NET console app to connect to an AI mo
:::zone target="docs" pivot="azure-openai"

```bash
dotnet package add Azure.Identity
dotnet package add Azure.AI.OpenAI
dotnet package add Microsoft.Extensions.AI.OpenAI
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end

:::zone target="docs" pivot="openai"

```bash
dotnet package add OpenAI
dotnet package add Microsoft.Extensions.AI.OpenAI
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end
Expand Down
24 changes: 12 additions & 12 deletions docs/ai/quickstarts/build-vector-search-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,13 +70,13 @@ Complete the following steps to create a .NET console app that can:
:::zone target="docs" pivot="azure-openai"

```bash
dotnet package add Azure.Identity
dotnet package add Azure.AI.OpenAI
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
dotnet package add Microsoft.Extensions.VectorData.Abstractions --prerelease
dotnet package add Microsoft.SemanticKernel.Connectors.InMemory --prerelease
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.VectorData.Abstractions --prerelease
dotnet add package Microsoft.SemanticKernel.Connectors.InMemory --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

The following list describes what each package is used for in the `VectorDataAI` app:
Expand All @@ -93,11 +93,11 @@ Complete the following steps to create a .NET console app that can:
:::zone target="docs" pivot="openai"

```bash
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
dotnet package add Microsoft.Extensions.VectorData.Abstractions --prerelease
dotnet package add Microsoft.SemanticKernel.Connectors.InMemory --prerelease
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.VectorData.Abstractions --prerelease
dotnet add package Microsoft.SemanticKernel.Connectors.InMemory --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

The following list describes what each package is used for in the `VectorDataAI` app:
Expand Down
2 changes: 1 addition & 1 deletion docs/ai/quickstarts/chat-local-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Complete the following steps to create a .NET console app that connects to your
1. Add the [Microsoft.Extensions.AI.Ollama](https://aka.ms/meai-ollama-nuget) packages to your app:

```dotnetcli
dotnet package add Microsoft.Extensions.AI.Ollama --prerelease
dotnet add package Microsoft.Extensions.AI.Ollama --prerelease
```

1. Open the new app in your editor of choice, such as Visual Studio Code.
Expand Down
4 changes: 2 additions & 2 deletions docs/ai/quickstarts/create-assistant.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Complete the following steps to create a .NET console app and add the package ne
1. Add the [OpenAI](https://www.nuget.org/packages/OpenAI) package to your app:

```dotnetcli
dotnet package add OpenAI --prerelease
dotnet add package OpenAI --prerelease
```

1. Open the new app in your editor of choice, such as Visual Studio Code.
Expand All @@ -94,7 +94,7 @@ Complete the following steps to create a .NET console app and add the package ne
1. Add the [Azure.AI.OpenAI](https://www.nuget.org/packages/Azure.AI.OpenAI) package to your app:

```dotnetcli
dotnet package add Azure.AI.OpenAI --prerelease
dotnet add package Azure.AI.OpenAI --prerelease
```

1. Open the new app in your editor of choice, such as Visual Studio Code.
Expand Down
16 changes: 8 additions & 8 deletions docs/ai/quickstarts/evaluate-ai-response.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,14 +35,14 @@ Complete the following steps to create an MSTest project that connects to your l
1. Navigate to the `TestAI` directory, and add the necessary packages to your app:

```dotnetcli
dotnet package add Azure.AI.OpenAI
dotnet package add Azure.Identity
dotnet package add Microsoft.Extensions.AI.Abstractions --prerelease
dotnet package add Microsoft.Extensions.AI.Evaluation --prerelease
dotnet package add Microsoft.Extensions.AI.Evaluation.Quality --prerelease
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.AI.OpenAI
dotnet add package Azure.Identity
dotnet add package Microsoft.Extensions.AI.Abstractions --prerelease
dotnet add package Microsoft.Extensions.AI.Evaluation --prerelease
dotnet add package Microsoft.Extensions.AI.Evaluation.Quality --prerelease
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

1. Run the following commands to add [app secrets](/aspnet/core/security/app-secrets) for your Azure OpenAI endpoint, model name, and tenant ID:
Expand Down
12 changes: 6 additions & 6 deletions docs/ai/quickstarts/generate-images.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,19 +51,19 @@ Complete the following steps to create a .NET console app to connect to an AI mo
:::zone target="docs" pivot="azure-openai"

```bash
dotnet package add Azure.AI.OpenAI
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end

:::zone target="docs" pivot="openai"

```bash
dotnet package add OpenAI
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end
Expand Down
18 changes: 9 additions & 9 deletions docs/ai/quickstarts/prompt-model.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,22 +54,22 @@ Complete the following steps to create a .NET console app to connect to an AI mo
:::zone target="docs" pivot="azure-openai"

```bash
dotnet package add Azure.Identity
dotnet package add Azure.AI.OpenAI
dotnet package add Microsoft.Extensions.AI.OpenAI
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end

:::zone target="docs" pivot="openai"

```bash
dotnet package add OpenAI
dotnet package add Microsoft.Extensions.AI.OpenAI
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package OpenAI
dotnet add package Microsoft.Extensions.AI.OpenAI
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end
Expand Down
20 changes: 10 additions & 10 deletions docs/ai/quickstarts/use-function-calling.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,23 +54,23 @@ Complete the following steps to create a .NET console app to connect to an AI mo
:::zone target="docs" pivot="azure-openai"

```bash
dotnet package add Azure.Identity
dotnet package add Azure.AI.OpenAI
dotnet package add Microsoft.Extensions.AI --prerelease
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.Identity
dotnet add package Azure.AI.OpenAI
dotnet add package Microsoft.Extensions.AI --prerelease
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end

:::zone target="docs" pivot="openai"

```bash
dotnet package add Microsoft.Extensions.AI --prerelease
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Microsoft.Extensions.AI --prerelease
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

:::zone-end
Expand Down
6 changes: 6 additions & 0 deletions docs/ai/semantic-kernel-dotnet-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,12 @@ The Semantic Kernel SDK is available as a NuGet package for .NET and integrates

Install the [`Microsoft.SemanticKernel`](https://www.nuget.org/packages/Microsoft.SemanticKernel) package using the following command:

```dotnetcli
dotnet add package Microsoft.SemanticKernel
```

Or, in .NET 10+:

```dotnetcli
dotnet package add Microsoft.SemanticKernel
```
Expand Down
18 changes: 9 additions & 9 deletions docs/ai/tutorials/evaluate-with-reporting.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,15 +32,15 @@ Complete the following steps to create an MSTest project that connects to the `g
1. Navigate to the `TestAIWithReporting` directory, and add the necessary packages to your app:

```dotnetcli
dotnet package add Azure.AI.OpenAI
dotnet package add Azure.Identity
dotnet package add Microsoft.Extensions.AI.Abstractions --prerelease
dotnet package add Microsoft.Extensions.AI.Evaluation --prerelease
dotnet package add Microsoft.Extensions.AI.Evaluation.Quality --prerelease
dotnet package add Microsoft.Extensions.AI.Evaluation.Reporting --prerelease
dotnet package add Microsoft.Extensions.AI.OpenAI --prerelease
dotnet package add Microsoft.Extensions.Configuration
dotnet package add Microsoft.Extensions.Configuration.UserSecrets
dotnet add package Azure.AI.OpenAI
dotnet add package Azure.Identity
dotnet add package Microsoft.Extensions.AI.Abstractions --prerelease
dotnet add package Microsoft.Extensions.AI.Evaluation --prerelease
dotnet add package Microsoft.Extensions.AI.Evaluation.Quality --prerelease
dotnet add package Microsoft.Extensions.AI.Evaluation.Reporting --prerelease
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
```

1. Run the following commands to add [app secrets](/aspnet/core/security/app-secrets) for your Azure OpenAI endpoint, model name, and tenant ID:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,13 @@ If you're writing a new ASP.NET Core application that needs to work with relatio
To use EF Core with a SQL Server database, run the following dotnet CLI command:

```dotnetcli
dotnet package add Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
```

To add support for an InMemory data source, for testing:

```dotnetcli
dotnet package add Microsoft.EntityFrameworkCore.InMemory
dotnet add package Microsoft.EntityFrameworkCore.InMemory
```

### The DbContext
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ To use `dotnet-svcutil.xmlserializer` in a .NET Core console application:
3. Add a package reference to `System.ServiceModel.Http` by running the following command:

```dotnetcli
dotnet package add System.ServiceModel.Http
dotnet add package System.ServiceModel.Http
```

4. Add the WCF Client code:
Expand Down Expand Up @@ -79,7 +79,7 @@ To use `dotnet-svcutil.xmlserializer` in a .NET Core console application:
5. Add a reference to the `dotnet-svcutil.xmlserializer` package by running the following command:

```dotnetcli
dotnet package add dotnet-svcutil.xmlserializer
dotnet add package dotnet-svcutil.xmlserializer
```

Running the command should add an entry to your project file similar to this:
Expand Down
6 changes: 3 additions & 3 deletions docs/core/additional-tools/xml-serializer-generator.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,13 +40,13 @@ The following instructions show you how to use XML Serializer Generator in a .NE
dotnet new console
```

2. Use the [`dotnet package add`](../tools/dotnet-package-add.md) command to add a reference to the Microsoft.XmlSerializer.Generator package.
2. Add a reference to the Microsoft.XmlSerializer.Generator package.

```dotnetcli
dotnet package add Microsoft.XmlSerializer.Generator -v 8.0.0
dotnet add package Microsoft.XmlSerializer.Generator -v 8.0.0
```

After running the [`dotnet package add`](../tools/dotnet-package-add.md) command, the following lines are added to your *MyApp.csproj* project file:
After running this command, the following lines are added to your *MyApp.csproj* project file:

```xml
<ItemGroup>
Expand Down
2 changes: 1 addition & 1 deletion docs/core/deploying/deploy-with-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ You can use the following app to explore the publishing commands. The app is cre
mkdir apptest1
cd apptest1
dotnet new console
dotnet package add Figgle
dotnet add package Figgle
```

The `Program.cs` or `Program.vb` file that is generated by the console template needs to be changed to the following:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,10 +45,10 @@ if we browse the web page.
To use OpenTelemetry, you need to add references to several NuGet packages.

```dotnetcli
dotnet package add OpenTelemetry
dotnet package add OpenTelemetry.Exporter.Console
dotnet package add OpenTelemetry.Extensions.Hosting
dotnet package add OpenTelemetry.Instrumentation.AspNetCore
dotnet add package OpenTelemetry
dotnet add package OpenTelemetry.Exporter.Console
dotnet add package OpenTelemetry.Extensions.Hosting
dotnet add package OpenTelemetry.Instrumentation.AspNetCore
```

Next, modify the source code in *Program.cs* so it looks like this:
Expand Down Expand Up @@ -206,7 +206,7 @@ Example work done
Add the [OpenTelemetry.Exporter.Console](https://www.nuget.org/packages/OpenTelemetry.Exporter.Console/) NuGet package.

```dotnetcli
dotnet package add OpenTelemetry.Exporter.Console
dotnet add package OpenTelemetry.Exporter.Console
```

Update Program.cs with additional OpenTelemetry `using` directives:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,15 +32,15 @@ Applications that target .NET 5 and later already have the necessary distributed
version 5 or greater. For libraries targeting netstandard, we recommend referencing the oldest version of the package which is still supported and contains the APIs your library needs.

```dotnetcli
dotnet package add System.Diagnostics.DiagnosticSource
dotnet add package System.Diagnostics.DiagnosticSource
```

Add the [OpenTelemetry](https://www.nuget.org/packages/OpenTelemetry/) and
[OpenTelemetry.Exporter.Console](https://www.nuget.org/packages/OpenTelemetry.Exporter.Console/) NuGet packages, which will be used to collect the telemetry.

```dotnetcli
dotnet package add OpenTelemetry
dotnet package add OpenTelemetry.Exporter.Console
dotnet add package OpenTelemetry
dotnet add package OpenTelemetry.Exporter.Console
```

Replace the contents of the generated Program.cs with this example source:
Expand Down
Loading
Loading