Skip to content

Commit 64da1f0

Browse files
baronfelgewarren
andauthored
Apply suggestions from code review
Co-authored-by: Genevieve Warren <[email protected]>
1 parent 6f279e5 commit 64da1f0

File tree

4 files changed

+20
-20
lines changed

4 files changed

+20
-20
lines changed

docs/core/diagnostics/dotnet-counters.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Counters can be read from applications running .NET 5 or later.
1414

1515
There are three ways to download and use `dotnet-counters`:
1616

17-
- **One-shot execution (Recommended):**
17+
- **One-shot execution (recommended):**
1818

1919
Starting with .NET 10.0.100, you can run `dotnet-counters` without permanent installation using [`dnx`](../tools/dotnet-tool-exec.md):
2020

@@ -38,7 +38,7 @@ There are three ways to download and use `dotnet-counters`:
3838
dotnet tool install --global dotnet-counters
3939
```
4040

41-
This method installs a `dotnet-counters` binary to your .NET SDK Tools path, which
41+
This command installs a `dotnet-counters` binary to your .NET SDK Tools path, which
4242
you can add to your PATH to easily invoke globally-installed tools.
4343

4444
- **Direct download:**

docs/core/tools/dotnet-tool-exec.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.date: 09/06/2025
55
---
66
# dotnet tool exec
77

8-
**This article applies to:** ✔️ .NET 10.0.100-preview.6 SDK and later versions
8+
**This article applies to:** ✔️ .NET 10.0.100 SDK and later versions
99

1010
## Name
1111

@@ -27,21 +27,21 @@ dotnet tool exec -h|--help
2727

2828
## Description
2929

30-
The `dotnet tool exec` command provides a one-shot tool invocation mode for .NET Tools. It automatically downloads the specified tool package to the NuGet cache and invokes it without modifying your system PATH or requiring permanent installation.
30+
The `dotnet tool exec` command provides a one-shot tool invocation mode for .NET Tools. It automatically downloads the specified tool package to the NuGet cache and invokes it without modifying your system `PATH` or requiring permanent installation.
3131

3232
When you run `dotnet tool exec`, the command:
3333

34-
1. Checks the version (or version range) you specify (or the latest version if none is specified) against your configured NuGet feeds to decide which package to download
35-
2. Downloads the specified package to the NuGet cache (if not already present)
36-
3. Invokes the tool with any provided arguments
37-
4. Returns the tool's exit code
34+
1. Checks the version (or version range) you specify (or the latest version if none is specified) against your configured NuGet feeds to decide which package to download.
35+
2. Downloads the specified package to the NuGet cache (if not already present).
36+
3. Invokes the tool with any provided arguments.
37+
4. Returns the tool's exit code.
3838

3939
`dotnet tool exec` works seamlessly with both global and local tools. If you have a local tool manifest available, it uses the manifest to determine which version of the tool to run.
4040

4141
This command also exists in two other forms for easier use
4242

43-
* `dotnet dnx` - a hidden alias for `dotnet tool exec` that is mostly used to give us a point to easily implement the
44-
* `dnx` - a shell script that invokes `dotnet dnx` from the SDK. This script is provided by the installer and is available on the PATH. It allows for very simple use of Tools directly via `dnx <toolname>`.
43+
* `dotnet dnx` - A hidden alias for `dotnet tool exec` that is mostly used to as a point to easily implement the ???
44+
* `dnx` - A shell script that invokes `dotnet dnx` from the SDK. This script is provided by the installer and is available on `PATH`. It allows for very simple use of tools directly via `dnx <toolname>`.
4545

4646
## Arguments
4747

@@ -61,11 +61,11 @@ This command also exists in two other forms for easier use
6161

6262
- **`--add-source <SOURCE>`**
6363

64-
Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not in a fallback cascade sequence. If the same package and version is available in multiple feeds, the fastest feed wins. See [What happens when a NuGet package is installed](/nuget/concepts/package-installation-process#what-happens-when-a-nuget-package-is-installed). This can be controlled through the use of NuGet Package Source Mapping. For more information, see [Package Source Mapping](/nuget/consume-packages/package-source-mapping).
64+
Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not in a fallback cascade sequence. If the same package and version is available in multiple feeds, the fastest feed wins. For more information, see [What happens when a NuGet package is installed](/nuget/concepts/package-installation-process#what-happens-when-a-nuget-package-is-installed). You can control this through the use of NuGet package source mapping. For more information, see [Package Source Mapping](/nuget/consume-packages/package-source-mapping).
6565

6666
- **`--configfile <FILE>`**
6767

68-
The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file will be used. If not specified, the hierarchy of configuration files from the current directory will be used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior).
68+
The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file are used. If not specified, the hierarchy of configuration files from the current directory are used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior).
6969

7070
- **`--disable-parallel`**
7171

@@ -77,7 +77,7 @@ This command also exists in two other forms for easier use
7777

7878
- **`--interactive`**
7979

80-
Allows the command to stop and wait for user input or action. For example, to complete authentication. This is defaulted to `true` when the command detects that it's being run directly by a user.
80+
Allows the command to stop and wait for user input or action, for example, to complete authentication. This option defaults to `true` when the command detects that it's being run directly by a user.
8181

8282
- **`--no-http-cache`**
8383

@@ -117,7 +117,7 @@ This command also exists in two other forms for easier use
117117

118118
## Comparison with other commands
119119

120-
This command is intended to be a unified way to work with .NET Tools. While the previously-available Tool installation commands remain available, we think that `dotnet tool exec` provides a simpler and more flexible experience for most users.
120+
This command is intended to be a unified way to work with .NET Tools. While the previously available tool installation commands remain available, `dotnet tool exec` provides a simpler and more flexible experience for most users.
121121

122122
| Command | Purpose | Installation | Scope |
123123
|---------|---------|--------------|-------|

docs/core/tools/global-tools-how-to-use.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ This tutorial teaches you how to install and use a global tool. You use a tool t
1616
* Complete the [first tutorial of this series](global-tools-how-to-create.md).
1717
* .NET 10.0.100 SDK or later (for `dnx`) - optional but recommended.
1818

19-
## Run the tool without installation (Recommended)
19+
## Run the tool without installation (recommended)
2020

2121
Starting with .NET 10.0.100, you can run .NET tools without permanent installation using [`dnx`](dotnet-tool-exec.md):
2222

@@ -28,7 +28,7 @@ Starting with .NET 10.0.100, you can run .NET tools without permanent installati
2828

2929
The `--add-source` parameter tells the .NET CLI to use the *./nupkg* directory as an additional source feed for NuGet packages when the tool is not available on NuGet.org.
3030

31-
## Use the tool as a global tool (Traditional installation)
31+
## Use the tool as a global tool (traditional installation)
3232

3333
If you prefer permanent installation for frequent use:
3434

docs/core/tools/local-tools-how-to-use.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ The tools listed in a manifest file are available to the current directory and s
5555

5656
When you use a CLI command that refers to a local tool, the SDK searches for a manifest file in the current directory and parent directories. If it finds a manifest file, but the file doesn't include the referenced tool, it continues the search up through parent directories. The search ends when it finds the referenced tool or it finds a manifest file with `isRoot` set to `true`.
5757

58-
## Install botsay as a local tool (Traditional approach)
58+
## Install botsay as a local tool (traditional approach)
5959

6060
Install the tool from the package that you created in the first tutorial:
6161

@@ -93,7 +93,7 @@ The *.config/dotnet-tools.json* file now has one tool:
9393

9494
Once installed as a local tool, you can invoke it in multiple ways:
9595

96-
1. Run the tool directly using `dnx`:
96+
- Run the tool directly using `dnx`:
9797

9898
```dotnetcli
9999
dnx microsoft.botsay --add-source ./nupkg hello from the bot
@@ -102,13 +102,13 @@ Once installed as a local tool, you can invoke it in multiple ways:
102102
> [!NOTE]
103103
> When using dnx with a local tool manifest, it automatically uses the version specified in the manifest.
104104
105-
2. Using `dotnet botsay`:
105+
- Using `dotnet botsay`:
106106

107107
```dotnetcli
108108
dotnet botsay hello from the bot
109109
```
110110

111-
3. Using `dotnet tool run`
111+
- Using `dotnet tool run`
112112

113113
```dotnetcli
114114
dotnet tool run botsay hello from the bot

0 commit comments

Comments
 (0)