Internalized 'docsgen' package

Author: cmaglie

.github/workflows/deploy-cobra-mkdocs-versioned-poetry.yml

@@ -21,7 +21,7 @@ on:
       - "go.sum"
       - "Taskfile.ya?ml"
       - "**.go"
-      - "docsgen/**"
+      - "internal/docsgen/**"
       - "rpc/**"
       - "mkdocs.ya?ml"
       - "poetry.lock"

.gitignore

@@ -28,8 +28,8 @@ __debug_bin*
 # Mkdocs
 /site/
 /public/
-/docsgen/arduino-cli
-/docsgen/arduino-cli.exe
+/internal/docsgen/arduino-cli
+/internal/docsgen/arduino-cli.exe
 /docs/rpc/*.md
 /docs/commands/*.md
 /docs/configuration.schema.json

Taskfile.yml

@@ -53,12 +53,12 @@ tasks:
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/deploy-cobra-mkdocs-versioned-poetry/Taskfile.yml
   go:cli-docs:
     desc: Generate command line interface reference documentation
-    dir: ./docsgen
+    dir: ./internal/docsgen
     cmds:
       # 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
+      - PATH=. {{.PROJECT_NAME}} ../../docs/commands
 
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-go-task/Taskfile.yml
   go:fix:

docsgen/main.go renamed to internal/docsgen/main.go

@@ -7,6 +7,6 @@ at the source:
 
 - **en.po** - edit the string in the source code file indicated by the comment above it <br /> e.g., a comment
   `#: commands/upload/upload.go:615` indicates the source string is at line 615 of the file
-  [`commands/upload/upload.go`](../../commands/upload/upload.go)
+  [`commands/upload/upload.go`](../../../commands/upload/upload.go)
 - **All other files** - the localization is done on **Transifex**: <br />
   https://explore.transifex.com/arduino-1/arduino-cli/