Wrap the workflow header comment to the yamllint line limit

No issue closed: CI change requested by S01.

.gitea/workflows/ci.yml

@@ -1,7 +1,8 @@
-# Continuous integration for the squirrel census project: runs the pytest tests
-# on Python 3.13 for every push and pull request. Read by Gitea Actions (a
-# runner must be registered for the repository). It changes nothing outside the
-# repository and uses no secret. Decision: MIL-001 task "Add CI workflow".
+# Continuous integration for the squirrel census project: lints the YAML and
+# workflow files and runs the pytest tests on Python 3.13 for every push and
+# pull request. Read by Gitea Actions (a runner must be registered for the
+# repository). It changes nothing outside the repository and uses no secret.
+# Decision: MIL-001 task "Add CI workflow".
 # Host: Gitea Actions; uses only github.* contexts, so it also runs on GitHub.
 
 name: Tests
@@ -42,5 +43,11 @@ jobs:
           .venv/bin/python -m pip install --upgrade "pip==${PIP_VERSION}"
           .venv/bin/python -m pip install -e ".[dev]"
 
+      - name: Lint the YAML files
+        run: .venv/bin/python -m yamllint -c .yamllint.yml .gitea .yamllint.yml
+
+      - name: Lint the workflow files
+        run: .venv/bin/actionlint .gitea/workflows/*.yml
+
       - name: Run the tests
         run: .venv/bin/python -m pytest

.yamllint.yml

@@ -6,3 +6,6 @@ rules:
     max: 100
   truthy:
     check-keys: false
+  # Line endings are normalised by git (LF in the repository, CRLF in some
+  # Windows checkouts), so the rule would fail on a local checkout only.
+  new-lines: disable

README.md

@@ -20,7 +20,7 @@ There are no runtime dependencies: the program uses only the Python standard lib
 ## Set up
 
 Create a local virtual environment named `.venv` in the project folder, upgrade `pip`
-and install the project with its development tools (pytest, ruff, mypy).
+and install the project with its development tools (pytest, ruff, mypy, yamllint, actionlint).
 
 ### Windows powershell
 
@@ -90,7 +90,8 @@ it is present.
 
 The workflow [`.gitea/workflows/ci.yml`][ci] runs for every push to `main` and for every
 pull request. It sets up Python 3.13, creates a `.venv`, upgrades `pip`, installs the
-project with `.[dev]` and runs `python -m pytest`. It uses `github.*` contexts only, so
+project with `.[dev]`, lints the YAML and workflow files with `yamllint` and
+`actionlint`, and runs `python -m pytest`. It uses `github.*` contexts only, so
 it also runs on GitHub Actions.
 
 ## Build the source documentation

pyproject.toml

@@ -22,7 +22,8 @@ classifiers = [
 
 [project.optional-dependencies]
 dev = ["pytest==9.1.1", "ruff==0.17.0", "mypy==2.4.0",
-  "pyyaml==6.0.3", "types-PyYAML==6.0.12.20260906"]
+  "pyyaml==6.0.3", "types-PyYAML==6.0.12.20260906",
+  "yamllint==1.38.0", "actionlint-py==1.7.12.25"]
 
 [tool.setuptools.packages.find]
 where = ["src"]

wiki/Install.da.md

@@ -2,7 +2,7 @@
 
 # Installation
 
-Projektet kræver **Python 3.13 eller nyere**. Det har ingen kørselsafhængigheder; `pytest`, `ruff` og `mypy` er udviklingsværktøjer.
+Projektet kræver **Python 3.13 eller nyere**. Det har ingen kørselsafhængigheder; `pytest`, `ruff`, `mypy`, `yamllint` og `actionlint` er udviklingsværktøjer.
 
 ## Windows PowerShell
 

wiki/Install.md

@@ -2,7 +2,7 @@
 
 # Install
 
-The project needs **Python 3.13 or later**. It has no runtime dependencies; `pytest`, `ruff` and `mypy` are development tools.
+The project needs **Python 3.13 or later**. It has no runtime dependencies; `pytest`, `ruff`, `mypy`, `yamllint` and `actionlint` are development tools.
 
 ## Windows PowerShell
 

wiki/Install.ms.md

@@ -2,7 +2,7 @@
 
 # Pemasangan
 
-Projek ini memerlukan **Python 3.13 atau lebih baharu**. Ia tiada kebergantungan masa jalan; `pytest`, `ruff` dan `mypy` ialah alat pembangunan.
+Projek ini memerlukan **Python 3.13 atau lebih baharu**. Ia tiada kebergantungan masa jalan; `pytest`, `ruff`, `mypy`, `yamllint` dan `actionlint` ialah alat pembangunan.
 
 ## Windows PowerShell