diff --git a/src/Microsoft.DotNet.Watcher.Tools/README.md b/src/Microsoft.DotNet.Watcher.Tools/README.md
index ec769af3e6..1ad4f241c9 100644
--- a/src/Microsoft.DotNet.Watcher.Tools/README.md
+++ b/src/Microsoft.DotNet.Watcher.Tools/README.md
@@ -4,6 +4,8 @@ dotnet-watch
### How To Install
+**project.json**
+
Add `Microsoft.DotNet.Watcher.Tools` to the `tools` section of your `project.json` file.
Use the version "1.0.0-preview2-final" if you are using .NET Core 1.0.0 and use "1.0.0-preview3-final" if you are using .NET Core 1.1.0.
@@ -18,18 +20,28 @@ Use the version "1.0.0-preview2-final" if you are using .NET Core 1.0.0 and use
}
```
+**MSBuild**
+Install `Microsoft.DotNet.Watcher.Tools` as a `DotNetCliReference` to your project.
+
+```xml
+
+
+
+```
+
+
### How To Use
dotnet watch [-?|-h|--help]
- dotnet watch [options] [[--] ...]
+ dotnet watch [options] [[--] ...]
Options:
-?|-h|--help Show help information
-q|--quiet Suppresses all output except warnings and errors
-v|--verbose Show verbose output
-Add `watch` after `dotnet` in the command that you want to run:
+Add `watch` after `dotnet` and before the command arguments that you want to run:
| What you want to run | Dotnet watch command |
| ---------------------------------------------- | -------------------------------------------------------- |
@@ -50,27 +62,13 @@ Some configuration options can be passed to `dotnet watch` through environment v
dotnet-watch can be configured from the MSBuild project file being watched.
-**Project References**
-
-By default, dotnet-watch will scan the entire graph of project references and watch all files within those projects.
-
-dotnet-watch will ignore project references with the `Watch="false"` attribute.
-
-```xml
-
-
-
-```
-
**Watch items**
-dotnet-watch will watch all items in the "Watch" item group.
-By default, this group inclues all items in "Compile" and "EmbeddedResource".
+dotnet-watch will watch all items in the **Watch** item group.
+By default, this group inclues all items in **Compile** and **EmbeddedResource**.
More items can be added to watch in a project file by adding items to 'Watch'.
-Example:
-
```xml
@@ -86,7 +84,20 @@ Example:
-
+
+
+
+```
+
+**Project References**
+
+By default, dotnet-watch will scan the entire graph of project references and watch all files within those projects.
+
+dotnet-watch will ignore project references with the `Watch="false"` attribute.
+
+```xml
+
+
```
@@ -100,6 +111,6 @@ Example:
```xml
-
+
```
\ No newline at end of file