Merge pull request #196 from per1234/reword-infra-docs

Improve wording/formatting of infrastructure documentation

Author: per1234

.github/workflows/check-prettier-formatting-task.yml

@@ -13,6 +13,7 @@ on:
       - "**/.prettierrc*"
       # Prettier-covered file patterns are defined by:
       # https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml
+      #
       # CSS
       - "**.css"
       - "**.wxss"

Taskfile.yml

@@ -221,7 +221,7 @@ tasks:
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-go-task/Taskfile.yml
   go:lint:
     desc: |
-      Lint Go code.
+      Lint Go code
       Environment variable parameters:
       - GO_MODULE_PATH: Path of the Go module root (default: {{.DEFAULT_GO_MODULE_PATH}}).
       - GO_PACKAGES: List of Go packages to modernize (default: all packages of the module).
@@ -462,7 +462,7 @@ tasks:
 
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-poetry-task/Taskfile.yml
   poetry:sync:
-    desc: Sync poetry.lock
+    desc: Sync Poetry lockfile
     deps:
       - task: poetry:install
     cmds:
@@ -472,7 +472,7 @@ tasks:
 
   # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-poetry-task/Taskfile.yml
   poetry:validate:
-    desc: Validate pyproject.toml
+    desc: Validate Poetry configuration
     deps:
       - task: poetry:install
     cmds:

pyproject.toml

@@ -10,8 +10,8 @@ python = "~3.9"
 yamllint = "^1.37.1"
 codespell = "^2.4.1"
 
-# The dependencies in this group are installed using pipx; NOT Poetry. The use of a `poetry` section is a hack required
-# in order to be able to manage updates of these dependencies via Dependabot, as used for all other dependencies.
+# The dependencies in this group are installed using pipx; NOT Poetry. The use of the `tool.poetry.group` super-table
+# is a hack required in order to be able to manage updates of these dependencies via Dependabot.
 [tool.poetry.group.pipx]
 optional = true