What's changed
Added
- Heading hierarchy validation — new
validate_headings.pyscript checks RST files for TYPO3 heading convention violations:- First section heading not using
=(h2) - Non-standard underline characters (e.g.
^) - Skipped heading levels (e.g. h2 directly to h4 without h3)
- First section heading not using
- CHANGELOG.md — comprehensive changelog covering all releases from v1.0.0
Fixed
set -ecrash invalidate_docs.sh—((WARNINGS++))withset -eexits the script when the counter is 0 because bash treats((0))as falsy. Replaced all((VAR++))with safeVAR=$((VAR + 1))arithmetic.- Command injection in heading check — shell variable was interpolated directly into
python3 -c; extracted to separate Python script withsys.argv[1]for secure filename passing.
Motivated by TYPO3-Documentation/TYPO3CMS-Guide-HowToDocument#510 where extracted pages retained old heading levels.
Full Changelog: v2.5.4...v2.6.0