diff --git a/docs/building-apps/build-properties.md b/docs/building-apps/build-properties.md
index c93f44b6c9b0..4efc424a29ad 100644
--- a/docs/building-apps/build-properties.md
+++ b/docs/building-apps/build-properties.md
@@ -352,9 +352,7 @@ See [BuildIpa](#buildipa) for iOS and tvOS projects.
 
 ## Device
 
-Specifies which mobile device or emulator to target when using `dotnet run
---device <Device>` or MSBuild targets that interact with devices (such as
-`Run`, `Install`, or `Uninstall`).
+Specifies which mobile device or simulator to target when using `dotnet run --device <Device>` or MSBuild targets that interact with devices (such as `Run`, `Install`, or `Uninstall`).
 
 The value can be anything the command-line tools `simctl` or `devicectl`
 accept for the device name; this is typically either the UDID or the name of
diff --git a/docs/building-apps/build-targets.md b/docs/building-apps/build-targets.md
index 86a0ff27503a..fbf0abff811e 100644
--- a/docs/building-apps/build-targets.md
+++ b/docs/building-apps/build-targets.md
@@ -47,8 +47,8 @@ Added in .NET 11.
 ## Run
 
 Builds the source code within a project and all dependencies, and then deploys and runs it
-on a default simulator/device. A specific deployment target can be set by using the `$(Device)` property. 
+on a default simulator/device. A specific deployment target can be set by using the `$(Device)` property.
 
 ```dotnetcli
-dotnet build -t:Run project.csproj -p:Device=$(MY_DEVICE_UDID)
+dotnet build -t:Run project.csproj -p:Device=<udid>
 ```