Skip to content

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

Closed
@baronfel

Description

@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).

Image

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

Metadata

Metadata

Assignees

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions