Added and checked file headers

Author: rimi-itk

.github/workflows/documentation.yaml

@@ -12,3 +12,15 @@ jobs:
       # Check that documentation has not changed.
       - run: |
           git diff --exit-code docs/github-action-templates.md
+
+  check-github-actions-documentation:
+    runs-on: ubuntu-latest
+    name: Check that Github Actions documentation is up to date
+    steps:
+      - uses: actions/checkout@v4
+      - uses: arduino/setup-task@v2
+      - run: |
+          task github-actions:update-headers --yes
+      # Check that files hav not changed.
+      - run: |
+          git diff --exit-code github/workflows/

Taskfile.yml

@@ -41,6 +41,32 @@ tasks:
       # Link to clean up.
       - task lint:markdown -- docs/github-action-templates.md
 
+  github-actions:update-headers:
+    prompt: "Updating headers may break things, so check result afterwards. Really update headers?"
+    desc: "Update headers in GitHub Actions templates"
+    cmds:
+      - |
+        for f in github/workflows/*.yaml; do
+          echo "$f"
+          # If file starts with `# ` …
+          if [[ $(head --lines=1 "$f") =~ "^# " ]]; then
+            # … replace the header.
+            # This is done by deleting all lines from the top of the file to a blank line.
+            docker run --rm --volume=$PWD:/app itkdev/php8.3-fpm:latest sed -i '1,/^$/d' "$f"
+          fi
+
+          # Write header and file into temporary file.
+          (
+          echo "# Do not edit this file! Make a pull request on changing";
+          echo "# $f in";
+          echo "# https://github.com/itk-dev/devops_itkdev-docker if need be.";
+          echo "";
+          cat "$f"
+          ) > "$f.tmp"
+          # Replace original file with temporary file.
+          mv "$f.tmp" "$f"
+        done
+
   lint:markdown:
     desc: "Lint Markdown"
     cmds:

github/workflows/composer.yaml

@@ -1,3 +1,7 @@
+# Do not edit this file! Make a pull request on changing
+# github/workflows/composer.yaml in
+# https://github.com/itk-dev/devops_itkdev-docker if need be.
+
 ### ## Composer
 ###
 ### Validates composer.json and checks that it's normalized.

github/workflows/drupal.yaml

@@ -1,3 +1,7 @@
+# Do not edit this file! Make a pull request on changing
+# github/workflows/drupal.yaml in
+# https://github.com/itk-dev/devops_itkdev-docker if need be.
+
 ### ## Drupal
 ###
 ### Checks that site can be installed and can be updated (from base branch on

github/workflows/markdown.yaml

@@ -1,3 +1,7 @@
+# Do not edit this file! Make a pull request on changing
+# github/workflows/markdown.yaml in
+# https://github.com/itk-dev/devops_itkdev-docker if need be.
+
 ### ## Markdown
 ###
 ### Uses [itkdev/markdownlint](https://hub.docker.com/r/itkdev/markdownlint) to