added command reference generator

Author: Massimiliano Pippi

.gitignore

@@ -20,3 +20,7 @@ venv
 
 # Misc.
 .DS_Store
+
+# Mkdocs
+/public/
+/docsgen/arduino-cli

docsgen/Taskfile.yml

@@ -0,0 +1,12 @@
+version: '2'
+
+tasks:
+  gen:commands:
+    desc: Generate commands reference
+    cmds:
+      # docs will generate examples using os.Args[0] so we need to call
+      # the generator `arduino-cli`
+      - go build -o arduino-cli
+      # we invoke `arduino-cli` like this instead of `./arduino-cli` to remove
+      # the `./` chars from the examples
+      - PATH=. arduino-cli ../docs/commands

docsgen/go.mod

@@ -0,0 +1,8 @@
+module github.com/arduino/arduino-cli/docsgen
+
+go 1.13
+
+require (
+	github.com/arduino/arduino-cli v0.0.0-20200228161349-4b874a02b096
+	github.com/spf13/cobra v0.0.6
+)