[TASK] Add reusable CI workflows for TYPO3-Documentation repos#56
Conversation
Add centralized, reusable GitHub Actions workflows that can be called by repositories across the TYPO3-Documentation organization: - backport.yml: Backport merged PRs via korthout/backport-action - docs-render.yml: Documentation rendering check - php-quality.yml: Code quality (CS Fixer, PHPStan, XML lint) - php-tests.yml: PHP test matrix (unit + integration) All actions are SHA-pinned. Reusable workflows execute in this repo's context, so only this repo's action allow-list needs maintenance. Ref: TYPO3-Documentation/TYPO3CMS-Reference-CoreApi#6414
|
I think we should create a test first in a repo where SHA pinning is enabled before we roll it out. In my tests the @main syntax was also not allowed as a version pin even it was "inlined". |
|
Mergin the workflows to test them out we can always decide to move them afterwards |
|
Hi @garvinhicking,
Dunno what you mean by "inlined"
|
Problem
The TYPO3-Documentation org has ~60 workflow files across ~29 repos with identical CI patterns (backport, docs rendering, PHP tests, code quality). When action SHAs change or tooling breaks (e.g.
m-kuhn/backport@30b6e83missingdist/index.js), each repo must be fixed individually.Additionally, the org's GitHub Actions allow-list with SHA-pinned actions means composite actions that internally call other actions (like
ramsey/composer-install→actions/cache@v4) break silently when inner SHAs change.Solution
Add four reusable workflows to this repository (which already serves as the org's central CI/CD hub):
reusable-backport.ymlkorthout/backport-actionreusable-docs-render.ymlreusable-php-quality.ymlreusable-php-tests.ymlReusable workflows execute in this repo's context, so only this repo's action references need to stay current. Callers reference a single workflow and inherit all updates automatically.
Example caller (backport)
All actions are SHA-pinned. Each workflow accepts optional inputs with sensible defaults.
Context
Requested by @linawolf in TYPO3-Documentation/TYPO3CMS-Reference-CoreApi#6414 (comment) — moving the workflows from netresearch/typo3-docs-ci-workflows into the org's own maintenance scope.
Benefits