2 Commits
Author SHA1 Message Date
joergmartinandClaude Opus 5.5 ab6c0cce28 idf-ci v1.4.0: Changelog-Prüfung im Pre-Flight
- Neuer Pre-Flight-Schritt in release-plugin.yml: findet im Block der neuen
  Version Code in Backticks und Shortcodes ([wort ...], [/wort]) und bricht
  mit Zeilenangabe ab. Markdown-Links bleiben erlaubt.
- Warum: Guide-Regel "Was nicht in den Changelog gehört" (05.11.2026) hängt
  sonst am Vorsatz dessen, der schreibt. Ältere Blöcke werden nicht geprüft.

Refs ideenfabrik/idf-plugin-template#12

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-08 17:06:52 +01:00
joergmartinandClaude Opus 5.5 375ebabc1d Doku: Regeln stehen im Guide statt in Notion (Notion-Migration T10)
Notion ist seit 07.11.2026 nur noch Archiv (Export 08.11.2026). Refs ideenfabrik/apps-v2#2534

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-08 11:40:42 +01:00
4 changed files with 56 additions and 5 deletions

No files matched your search

+46
View File
@@ -197,6 +197,52 @@ jobs:
fi fi
echo "Stable tag OK: $STABLE_TAG" echo "Stable tag OK: $STABLE_TAG"
# Guide-Regel „Was nicht in den Changelog gehört“: der Changelog sagt nur,
# was gemacht wurde. Geprüft wird nur der Block der neuen Version, damit
# der Altbestand kein Release blockiert.
- name: Pre-Flight — Changelog ohne Code und Shortcodes
if: steps.vars.outputs.skip != 'true'
shell: bash
env:
VERSION: ${{ steps.vars.outputs.version }}
run: |
set -euo pipefail
python3 - <<'PY'
import re, sys, os
version = os.environ["VERSION"]
with open("CHANGELOG.md", encoding="utf-8") as f:
content = f.read()
pat = re.compile(
r"^##\s+v" + re.escape(version) + r"[^\n]*\n(.*?)(?=^##\s+v\d|^---\s*$|\Z)",
re.MULTILINE | re.DOTALL,
)
m = pat.search(content)
if not m:
# Fehlender Block meldet der nächste Schritt.
sys.exit(0)
erste_zeile = content.count("\n", 0, m.start(1)) + 1
# Markdown-Links [text](url) sind erlaubt, Shortcodes [wort ...] und [/wort] nicht.
link = re.compile(r"\[[^\]\n]*\]\([^)\n]*\)")
shortcode = re.compile(r"\[/?[a-z][a-z0-9_-]*(?:\s[^\]\n]*)?\](?![(\[])")
funde = []
for i, zeile in enumerate(m.group(1).split("\n")):
rest = link.sub("", zeile)
if "`" in rest:
funde.append((erste_zeile + i, "Code in Backticks", zeile))
sc = shortcode.search(rest)
if sc:
funde.append((erste_zeile + i, f"Shortcode {sc.group(0)}", zeile))
if not funde:
print(f"Changelog v{version} OK: kein Code, keine Shortcodes")
sys.exit(0)
for nr, art, zeile in funde:
print(f"::error file=CHANGELOG.md,line={nr}::{art}: {zeile.strip()[:200]}")
print(f"::error::CHANGELOG.md v{version}: {len(funde)} Fund(e). Der Changelog sagt nur, was gemacht wurde: "
"keine Shortcodes, kein Code, keine Funktions-, Hook-, Datei- oder Feldnamen, ein Eintrag eine Zeile "
"(Guide, Was nicht in den Changelog gehört). Details gehören in Commit, README oder Issue.")
sys.exit(1)
PY
- name: Changelog-Block aus CHANGELOG.md extrahieren - name: Changelog-Block aus CHANGELOG.md extrahieren
if: steps.vars.outputs.skip != 'true' if: steps.vars.outputs.skip != 'true'
id: changelog id: changelog
+5
View File
@@ -1,5 +1,10 @@
# Changelog # Changelog
## v1.4.0
### Hinzugefügt
- Der Build bricht ab, wenn im Changelog der neuen Version Code oder Shortcodes stehen, und nennt die betroffenen Zeilen.
## v1.3.0 ## v1.3.0
### Geändert ### Geändert
+3 -5
View File
@@ -87,6 +87,8 @@ Damit der Reusable Workflow durchläuft, müssen im Plugin-Repo vorhanden sein:
Alle vier Versionen (Tag, Plugin-Header, PHP-Konstante, `Stable tag:`) müssen identisch sein. Der Pre-Flight-Check im Reusable bricht sonst ab. Alle vier Versionen (Tag, Plugin-Header, PHP-Konstante, `Stable tag:`) müssen identisch sein. Der Pre-Flight-Check im Reusable bricht sonst ab.
Dazu prüft der Pre-Flight den Block der neuen Version in `CHANGELOG.md`: steht dort Code in Backticks oder ein Shortcode (`[wort ...]`, Markdown-Links sind erlaubt), bricht der Build mit Zeilenangabe ab. Regel im Guide: „Was nicht in den Changelog gehört“. Ältere Blöcke prüft er nicht.
## Aufteilung Changelog-Pflege ## Aufteilung Changelog-Pflege
- **`CHANGELOG.md`** ist die **einzige Pflege-Stelle für den Changelog** - einheitlich über alle IDF-Projekte (Software, Flow, Plugins). Du schreibst den neuen Block hier, fertig. - **`CHANGELOG.md`** ist die **einzige Pflege-Stelle für den Changelog** - einheitlich über alle IDF-Projekte (Software, Flow, Plugins). Du schreibst den neuen Block hier, fertig.
@@ -107,8 +109,4 @@ Breaking Changes am Workflow → neuer Major-Tag, nutzende Repos müssen manuell
## Dokumentation ## Dokumentation
Konzeptionelle Grundlagen und der Plugin-Release-Workflow liegen in Notion: Die Regeln für alle Plugins (Deployment, Versionierung, Labels, Tag und Release) stehen im Guide, Konventionen, Bereich WP-Plugins und Global. Die früheren Notion-Seiten dazu sind nur noch im Notion-Archiv (Export vom 08.11.2026).
- [Deployment & Versionierung](https://www.notion.so/32b36ebfe9178147ad16ee214302c994)
- [Plugin-Migration auf Git - Checkliste](https://www.notion.so/34b36ebfe9178195980fd4a723ebfde5)
- [Git- & Issue-Workflow](https://www.notion.so/34b36ebfe91781519276f301aac0d74c)
+2
View File
@@ -66,6 +66,8 @@ Damit der Reusable Workflow durchläuft, müssen im Plugin-Repo vorhanden sein:
Alle vier Werte (Tag, Plugin-Header-`Version:`, PHP-Konstante, `Stable tag:` in `readme.txt`) müssen identisch sein. Der Pre-Flight-Check im Reusable bricht sonst ab. Alle vier Werte (Tag, Plugin-Header-`Version:`, PHP-Konstante, `Stable tag:` in `readme.txt`) müssen identisch sein. Der Pre-Flight-Check im Reusable bricht sonst ab.
Dazu prüft der Pre-Flight den Block der neuen Version in `CHANGELOG.md`: steht dort Code in Backticks oder ein Shortcode (`[wort ...]`, Markdown-Links sind erlaubt), bricht der Build mit Zeilenangabe ab. Regel im Guide: „Was nicht in den Changelog gehört“. Ältere Blöcke prüft er nicht.
**Pflege-Aufteilung:** Changelog-Einträge nur in `CHANGELOG.md` pflegen. `readme.txt` bekommt seine `== Changelog ==` beim Release automatisch generiert - manuelle Einträge dort werden überschrieben. **Pflege-Aufteilung:** Changelog-Einträge nur in `CHANGELOG.md` pflegen. `readme.txt` bekommt seine `== Changelog ==` beim Release automatisch generiert - manuelle Einträge dort werden überschrieben.
## Release-Ablauf (Agent/Mensch) ## Release-Ablauf (Agent/Mensch)