docs(nx): update affected files description

Update the description of the `--files` options for the `affected`
command, making it clearer (hopefully).

close #1535

docs/angular/api-workspace/npmscripts/affected-apps.md

@@ -48,7 +48,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected-build.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected-dep-graph.md

@@ -64,7 +64,7 @@ output file (e.g. --file=.vis/output.json)
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected-e2e.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected-libs.md

@@ -48,7 +48,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected-lint.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected-test.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/affected.md

@@ -72,7 +72,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/dep-graph.md

@@ -52,7 +52,7 @@ output file (e.g. --file=.vis/output.json)
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/format-check.md

@@ -30,7 +30,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/angular/api-workspace/npmscripts/format-write.md

@@ -30,7 +30,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-apps.md

@@ -48,7 +48,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-build.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-dep-graph.md

@@ -64,7 +64,7 @@ output file (e.g. --file=.vis/output.json)
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-e2e.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-libs.md

@@ -48,7 +48,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-lint.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected-test.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/affected.md

@@ -72,7 +72,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/dep-graph.md

@@ -52,7 +52,7 @@ output file (e.g. --file=.vis/output.json)
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/format-check.md

@@ -30,7 +30,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/react/api-workspace/npmscripts/format-write.md

@@ -30,7 +30,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-apps.md

@@ -48,7 +48,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-build.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-dep-graph.md

@@ -64,7 +64,7 @@ output file (e.g. --file=.vis/output.json)
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-e2e.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-libs.md

@@ -48,7 +48,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-lint.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected-test.md

@@ -66,7 +66,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/affected.md

@@ -72,7 +72,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/dep-graph.md

@@ -52,7 +52,7 @@ output file (e.g. --file=.vis/output.json)
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/format-check.md

@@ -30,7 +30,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

docs/web/api-workspace/npmscripts/format-write.md

@@ -30,7 +30,7 @@ Exclude certain projects from being processed
 
 ### files
 
-A list of files delimited by commas
+Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
 
 ### head
 

packages/workspace/src/command-line/nx-commands.ts

@@ -206,7 +206,8 @@ function withFormatOptions(yargs: yargs.Argv): yargs.Argv {
 function withAffectedOptions(yargs: yargs.Argv): yargs.Argv {
   return yargs
     .option('files', {
-      describe: 'A list of files delimited by commas',
+      describe:
+        'Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas',
       type: 'array',
       requiresArg: true,
       coerce: parseCSV