Update the dotnet CLI docs to document the new noun-first command forms

[baronfel]

Type of issue

Missing information

Description

In 9.0.300 and onwards the dotnet CLI added several new noun-first command (dotnet package add) for existing verb-first forms (dotnet add package). This was done based on significant user feedback about mixing up commands, since the majority of the subcommand-based commands in the SDK were noun-first.

In addition, many other CLIs that users interact with as part of their work have conditioned them to expect noun-first grammars.

Specifically, the following new forms are available:

• dotnet package list
• dotnet reference list
• dotnet package add
• dotnet reference add
• dotnet package remove
• dotnet reference remove

The existing, verb-first forms of these commands have not been removed - they remain functional and will not be removed in the near future. We may add a notification message to their use informing users about the new noun-first forms like we've done for the older dotnet new subcommands (picture below).

Implementation PR: dotnet/sdk#45384
Tracking Issue: dotnet/sdk#9650

Page URL

https://learn.microsoft.com/en-us/dotnet/core/tools/

Content source URL

https://github.com/dotnet/docs/blob/main/docs/core/tools/index.md

Document Version Independent Id

c6859ca6-e2b1-3645-872c-60390ffd429a

Article author

@tdykstra

Metadata

• ID: b7e47565-cc59-b1a6-24be-0143c550c0b2
• PlatformId: 71f88ad0-c497-bd84-bcae-a271c6be9107
• Service: dotnet-fundamentals

Related Issues

[gewarren]

This was fixed by #43917.