docs: document new flags

Author: marionebl

Diff for: @commitlint/cli/src/cli.js

@@ -89,6 +89,11 @@ const flags = {
 		alias: 'v',
 		type: 'boolean',
 		description: 'display version information'
+	},
+	verbose: {
+		alias: 'V',
+		type: 'boolean',
+		description: 'enable verbose output for reports without problems'
 	}
 };
 

Diff for: docs/reference-api.md

@@ -40,10 +40,30 @@ type ReportResult = {
 }
 
 type formatOptions = {
-  /*
+  /**
    * Color the output
-   */
+   **/
   color: boolean = true;
+
+  /**
+   * Signs to use as decoration for messages with severy 0, 1, 2
+   **/
+  signs: readonly [string; string; string] = [' ', '⚠', '✖'];
+  
+  /**
+   * Colors to use for messages with severy 0, 1, 2
+   **/
+  colors: readonly [string; string; string] = ['white', 'yellow', 'red'];
+
+  /**
+   * Print summary and inputs for reports without problems
+   **/
+  verbose: boolean = false;
+
+  /**
+   * URL to print as help for reports with problems
+   **/
+  helpUrl: string;
 }
 
 format(report?: Report = {}, options?: formatOptions = {}) => string[];

Diff for: docs/reference-cli.md

@@ -18,5 +18,6 @@
 --parser-preset, -p    configuration preset to use for conventional-commits-parser
 --quiet, -q            toggle console output
 --to, -t               upper end of the commit range to lint; applies if edit=false
---version, -v          display version information
+--version, -v          display version informationv
+--verbose, -V          print summary and inputs for reports without problems
 ```