docs: describe how to use the silent flag for dependencies (#680)

docs/docs/api_reference.md

@@ -280,6 +280,7 @@ tasks:
 | --------- | ---------------------------------- | ------- | -------------------------------------------------------- |
 | `task`    | `string`                           |         | The task to be execute as a dependency.                  |
 | `vars`    | [`map[string]Variable`](#variable) |         | Optional additional variables to be passed to this task. |
+| `silent`  | `bool`                             | `false` | Hides task name and command from output. The command's output will still be redirected to `STDOUT` and `STDERR`. |
 
 :::tip
 

docs/docs/usage.md

@@ -468,6 +468,7 @@ tasks:
         vars: { TEXT: 'before 1' }
       - task: echo_sth
         vars: { TEXT: 'before 2' }
+        silent: true
     cmds:
       - echo "after"
 
@@ -574,8 +575,8 @@ tasks:
       - echo "Another task"
 ```
 
-Overriding variables in the called task is as simple as informing `vars`
+Using the `vars` and `silent` attributes you can choose to pass variables and
-attribute:
+toggle [silent mode](#silent-mode) on a call-by-call basis:
 
 ```yaml
 version: '3'
@@ -591,6 +592,7 @@ tasks:
     cmds:
       - task: greet
         vars: { RECIPIENT: 'Cruel World' }
+        silent: true
 ```
 
 The above syntax is also supported in `deps`.

docs/static/schema.json

@@ -241,6 +241,10 @@
           "vars": {
             "description": "Values passed to the task called",
             "$ref": "#/definitions/3/vars"
+          },
+          "silent": {
+            "description": "Hides task name and command from output. The command's output will still be redirected to `STDOUT` and `STDERR`.",
+            "type": "boolean"
           }
         }
       },