Sync project infrastructure with assets

.codespellrc

@@ -3,7 +3,7 @@
 [codespell]
 # In the event of a false positive, add the problematic word, in all lowercase, to a comma-separated list here:
 ignore-words-list = ba,licence,ot
-skip = .git,./.licenses,__pycache__,node_modules,./other/clang-format-configuration/testdata/input/samples,./other/clang-format-configuration/testdata/golden,./other/clang-format-configuration/.clang-format,go.mod,go.sum,package-lock.json,poetry.lock,yarn.lock
+skip = ./.licenses,.git,__pycache__,node_modules,./other/clang-format-configuration/testdata/input/samples,./other/clang-format-configuration/testdata/golden,./other/clang-format-configuration/.clang-format,go.mod,go.sum,package-lock.json,poetry.lock,yarn.lock
 builtin = clear,informal,en-GB_to_en-US
 check-filenames =
 check-hidden =

.github/workflows/check-files-task.yml

@@ -15,9 +15,9 @@ on:
 jobs:
   run-determination:
     runs-on: ubuntu-latest
+    permissions: {}
     outputs:
       result: ${{ steps.determination.outputs.result }}
-    permissions: {}
     steps:
       - name: Determine if the rest of the workflow should run
         id: determination

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

@@ -11,6 +11,9 @@ on:
       - "Taskfile.ya?ml"
       - "**/.prettierignore"
       - "**/.prettierrc*"
+      # Prettier-covered file patterns are defined by:
+      # https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml
+      #
       # CSS
       - "**.css"
       - "**.wxss"
@@ -115,8 +118,6 @@ on:
       - "Taskfile.ya?ml"
       - "**/.prettierignore"
       - "**/.prettierrc*"
-      # Prettier-covered file patterns are defined by:
-      # https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml
       # CSS
       - "**.css"
       - "**.wxss"

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

@@ -7,12 +7,16 @@ on:
     paths:
       - ".github/workflows/*.ya?ml"
       - ".npmrc"
+      - "package.json"
+      - "package-lock.json"
       - "Taskfile.ya?ml"
       - "workflow-templates/*.ya?ml"
   pull_request:
     paths:
       - ".github/workflows/*.ya?ml"
       - ".npmrc"
+      - "package.json"
+      - "package-lock.json"
       - "Taskfile.ya?ml"
       - "workflow-templates/*.ya?ml"
   schedule:

Taskfile.yml

@@ -462,6 +462,7 @@ tasks:
 
   docs:generate:
     desc: Create all generated documentation content
+    run: when_changed
     # This is an "umbrella" task used to call any documentation generation processes the project has.
     # It can be left empty if there are none.
 
@@ -586,7 +587,8 @@ tasks:
           ! which ec \
           &>/dev/null
         then
-          echo "ec not found or not in PATH. Please install: https://github.com/editorconfig-checker/editorconfig-checker#installation"
+          echo "ec not found or not in PATH."
+          echo "Please install: https://github.com/editorconfig-checker/editorconfig-checker#installation"
           exit 1
         fi
       - ec
@@ -712,6 +714,7 @@ tasks:
             -s "{{.SCHEMA_PATH}}" \
             -d "{{.DATA_PATH}}"
 
+  # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-javascript-task/Taskfile.yml
   js:fix:
     desc: Fix JavaScript code linting violations
     deps:
@@ -724,6 +727,7 @@ tasks:
             --fix \
             .
 
+  # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/check-javascript-task/Taskfile.yml
   js:lint:
     desc: Lint JavaScript code
     deps:
@@ -1083,6 +1087,7 @@ tasks:
           flake8 \
             --show-source
 
+  # Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/test-python-poetry-task/Taskfile.yml
   python:test:
     desc: Run Python tests
     deps:

pyproject.toml

@@ -1,3 +1,4 @@
+# Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/poetry/pyproject.toml
 [tool.black]
 line-length = 120
 

workflow-templates/assets/deploy-mkdocs-versioned/siteversion/tests/__init__.py

@@ -1,4 +1,5 @@
-# Source: https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/test-python/__init__.py
+# Source:
+# https://github.com/arduino/tooling-project-assets/blob/main/workflow-templates/assets/test-python/__init__.py
 # Copyright 2021 ARDUINO SA (http://www.arduino.cc/)
 #
 # This software is released under the GNU General Public License version 3,

workflow-templates/check-prettier-formatting-task.yml

@@ -11,6 +11,9 @@ on:
       - "Taskfile.ya?ml"
       - "**/.prettierignore"
       - "**/.prettierrc*"
+      # Prettier-covered file patterns are defined by:
+      # https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml
+      #
       # CSS
       - "**.css"
       - "**.wxss"
@@ -115,8 +118,6 @@ on:
       - "Taskfile.ya?ml"
       - "**/.prettierignore"
       - "**/.prettierrc*"
-      # Prettier-covered file patterns are defined by:
-      # https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml
       # CSS
       - "**.css"
       - "**.wxss"