Cleaned up?

Author: rimi-itk

.github/workflows/documentation.yaml

@@ -25,7 +25,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: arduino/setup-task@v2
       - run: |
-          task github-actions:update-headers --yes
+          task github-actions:template-headers-update --yes
       # Check that files hav not changed.
       - run: |
           git diff --exit-code github/workflows/

.markdownlint.jsonc

@@ -0,0 +1,19 @@
+// markdownlint-cli configuration file (cf. https://github.com/igorshubovych/markdownlint-cli?tab=readme-ov-file#configuration)
+{
+  "default": true,
+  // https://github.com/DavidAnson/markdownlint/blob/main/doc/md013.md
+  "line-length": {
+    "line_length": 120,
+    "code_blocks": false,
+    "tables": false
+  },
+  // https://github.com/DavidAnson/markdownlint/blob/main/doc/md024.md
+  "no-duplicate-heading": {
+    "siblings_only": true
+  },
+  // https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections#creating-a-collapsed-section
+  // https://github.com/DavidAnson/markdownlint/blob/main/doc/md033.md
+  "no-inline-html": {
+    "allowed_elements": ["details", "summary"]
+  }
+}

.markdownlint.jsonc

@@ -0,0 +1,8 @@
+# https://github.com/igorshubovych/markdownlint-cli?tab=readme-ov-file#ignoring-files
+vendor/
+node_modules/
+LICENSE.md
+# Drupal
+web/*.md
+web/core/
+web/*/contrib/

.markdownlintignore

@@ -2,6 +2,9 @@
 
 version: '3'
 
+includes:
+  github-actions: ./task/Tasfile.github-actions.yml
+
 vars:
   GITHUB_ACTIONS_TEMPLATES_HEADER: |
     # Github Actions templates
@@ -16,63 +19,11 @@ vars:
   GITHUB_ACTIONS_TEMPLATES_FOOTER: |
 
 tasks:
-  github-actions:documentation:update:
-    desc: "Update GitHub Actions template documentation"
-    sources:
-      - github/workflows/*.yaml
-    generates:
-      - docs/github-action-templates.md
-    cmds:
-      - mkdir -p docs
-      - |
-        echo '{{.GITHUB_ACTIONS_TEMPLATES_HEADER}}' > docs/github-action-templates.md
-      - |
-        for f in github/workflows/*.yaml; do
-          echo "" >> docs/github-action-templates.md
-          echo "---" >> docs/github-action-templates.md
-          echo "" >> docs/github-action-templates.md
-
-          echo "[$f]($f)" >> docs/github-action-templates.md
-
-          cat "$f" | grep -E '^###( |$)' | sed -E -e 's/^### ?//' >> docs/github-action-templates.md
-        done
-      - |
-        echo "{{.GITHUB_ACTIONS_TEMPLATES_FOOTER}}" >> docs/github-action-templates.md
-      # 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 --user ${COMPOSE_USER:-deploy} 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:
-      # I cannot get itkdev/markdownlint to work as expected, i.e. as peterdavehello/markdownlint does …
-      - docker run --rm --volume "$PWD":/md peterdavehello/markdownlint markdownlint {{.GLOB}} --fix
-      - docker run --rm --volume "$PWD":/md peterdavehello/markdownlint markdownlint {{.GLOB}}
+      - docker run --rm --volume "$PWD":/md itkdev/markdownlint markdownlint {{.GLOB}} --fix
+      - docker run --rm --volume "$PWD":/md itkdev/markdownlint markdownlint {{.GLOB}}
     vars:
       # We use a block scalar (https://yaml-multiline.info/#block-scalars) here to make escaping (a little) easier.
       GLOB: >-

.markdownlintignore

@@ -0,0 +1,5 @@
+<?php
+// https://github.com/VincentLanglet/Twig-CS-Fixer/blob/main/docs/configuration.md#configuration-file
+$config = new TwigCsFixer\Config\Config();
+
+return $config;