Replace/remove project-specific references from versioned Cobra docs templates

The source content for the template files were from Arduino Lint, and contained references specific to Arduino Lint.
These were replaced by placeholders, or in the case of comments, the wording made universal.

Author: per1234

workflow-templates/assets/deploy-cobra-mkdocs-versioned-poetry/Taskfile.yml

@@ -1,15 +1,16 @@
 version: "3"
 
+vars:
+  PROJECT_NAME: TODO
+
 tasks:
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/deploy-cobra-mkdocs-versioned-poetry/Taskfile.yml
   docs:gen:
     desc: Generate command reference
     dir: ./docsgen
     cmds:
-      # docs will generate examples using os.Args[0] so we need to call
-      # the generator `arduino-lint`
-      - go build -o arduino-lint{{exeExt}}
-      # we invoke `arduino-lint` like this instead of `./arduino-lint` to remove
-      # the `./` chars from the examples
-      - PATH=. arduino-lint ../docs/commands
+      # Command examples use os.Args[0] so the docs generation binary must have the same filename as the project
+      - go build -o {{.PROJECT_NAME}}{{exeExt}}
+      # The binary is invoked like this instead of `./{{.PROJECT_NAME}}` to remove the `./` chars from the examples
+      - PATH=. {{.PROJECT_NAME}} ../docs/commands
       - task: docs:format

workflow-templates/assets/deploy-cobra-mkdocs-versioned-poetry/docsgen/go.mod

@@ -1,11 +1,12 @@
 // Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/deploy-cobra-mkdocs-versioned-poetry/docsgen/go.mod
-module github.com/arduino/arduino-lint/docsgen
+// TODO: replace MODULE_NAME with the project's module name
+module MODULE_NAME/docsgen
 
 go 1.14
 
-replace github.com/arduino/arduino-lint => ../
+replace MODULE_NAME => ../
 
 require (
-	github.com/arduino/arduino-lint v0.0.0
+	MODULE_NAME v0.0.0
 	github.com/spf13/cobra v1.1.1
 )

workflow-templates/assets/deploy-cobra-mkdocs-versioned-poetry/docsgen/main.go

@@ -2,8 +2,7 @@
 //
 // Copyright 2020 ARDUINO SA (http://www.arduino.cc/)
 //
-// This software is released under the GNU General Public License version 3,
-// which covers the main part of arduino-cli.
+// This software is released under the GNU General Public License version 3.
 // The terms of this license can be found at:
 // https://www.gnu.org/licenses/gpl-3.0.en.html
 //
@@ -13,13 +12,14 @@
 // Arduino software without disclosing the source code of your own applications.
 // To purchase a commercial license, send an email to license@arduino.cc.
 
-// Package main generates Markdown documentation for the Arduino Lint CLI.
+// Package main generates Markdown documentation for the project's CLI.
 package main
 
 import (
 	"os"
 
-	"github.com/arduino/arduino-lint/internal/cli"
+	// TODO: Replace CLI_PACKAGE_NAME with the project's Cobra CLI package name
+	"CLI_PACKAGE_NAME"
 	"github.com/spf13/cobra/doc"
 )