Merge pull request #761 from dotnet/dev/jorobich/update-docs

Update --include and --exclude documentation

docs/README.md

@@ -68,7 +68,7 @@ Running 3rd party analysis requires the use of a MSBuild solution or project fil
 
 ### Filter files to format
 
-You can further narrow the list of files to be formatted by limiting to set of included files that are not excluded. File globbing is supported.
+You can further narrow the list of files to be formatted by specifying a list of paths to include or exclude. When specifying folder paths the path must end with a directory separator. File globbing is supported.
 
 - `--include` - A list of relative file or folder paths to include in formatting.
 - `--exclude` - A list of relative file or folder paths to exclude from formatting.
@@ -90,4 +90,4 @@ dotnet format -f --include ./src/ ./tests/ --exclude ./src/submodule-a/ --check
 
 ### Validate formatting
 
-- `--check` - Formats files without saving changes to disk. Terminates with a non-zero exit code (`2`) if any files were formatted.
+- `--check` - Formats files without saving changes to disk. Terminates with a non-zero exit code (`2`) if any files were formatted.