Taskfile: use buf to generate docs

Author: alessio-perugini

Taskfile.yml

@@ -243,7 +243,8 @@ tasks:
   protoc:docs:
     desc: Generate docs for protobuf definitions
     cmds:
-      - '{{ default "protoc" .PROTOC_BINARY }} --doc_out=./docs/rpc --doc_opt=markdown,commands.md --proto_path=rpc ./rpc/cc/arduino/cli/commands/v1/*.proto'
+      - |
+        buf generate --template buf.doc.gen.yaml
 
   docs:include-configuration-json-schema:
     desc: Copy configuration JSON schema to make it available in documentation

buf.doc.gen.yaml

@@ -0,0 +1,10 @@
+version: v2
+plugins:
+  # Local plugin used to generate docs
+  # go install github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc@v1.4.1
+  - local: protoc-gen-doc
+    out: ./docs/rpc
+    opt:
+      - markdown,commands.md
+inputs:
+  - directory: ./rpc