Skip to content

Nutzer-Anleitungen statt Maintainer-READMEs auf Vorlagen-Galerie#146

Merged
flomotlik merged 1 commit into
mainfrom
issue/vorlagen-template-anleitungen-entrumpeln
Jun 8, 2026
Merged

Nutzer-Anleitungen statt Maintainer-READMEs auf Vorlagen-Galerie#146
flomotlik merged 1 commit into
mainfrom
issue/vorlagen-template-anleitungen-entrumpeln

Conversation

@flomotlik

Copy link
Copy Markdown
Contributor

Die Template-Detailseiten betteten bisher die maintainer-orientierte README.md jedes Templates wortwörtlich als "Anleitung" ein. Dadurch landeten technische Interna (build.py, SLA-Diff, CI-Validator, Issue-Nummern, "LANGUAGE-Vererbung auf STYLE-Ebene", bekannte SLA-Abweichungen) auf den öffentlichen Nutzerseiten — bei der Zeitung besonders ausgeprägt. Flyer/Falzflyer ohne README zeigten umgekehrt eine leere "Anleitung"-Überschrift.

Änderungen

  • USAGE.md als neue, nutzerorientierte Anleitungs-Quelle eingeführt — je eine für alle 15 Templates (öffnen → Inhalte ersetzen → Impressum → PDF).
  • gallery_build.py bettet jetzt USAGE.md statt README.md ein. README.md bleibt als Maintainer-Dokument erhalten, leakt aber nicht mehr auf die Seite.
  • Template-Detailseite blendet die "Anleitung"-Überschrift aus, wenn kein Inhalt vorhanden ist.
  • Galerie-Inhalte neu generiert; Astro-Build grün (24 Seiten, alle 15 Templates).

…rie-Seiten

Die Template-Detailseiten haben die README.md jedes Templates wortwoertlich als
"Anleitung" eingebettet. Damit landeten Maintainer-Interna (build.py, SLA-Diff,
CI-Validator, Issue-Nummern, "LANGUAGE-Vererbung auf STYLE-Ebene", bekannte
SLA-Abweichungen) auf den oeffentlichen Nutzerseiten — bei der Zeitung besonders
ausgepraegt. Flyer/Falzflyer ohne README zeigten umgekehrt eine leere
"Anleitung"-Ueberschrift.

- USAGE.md als neue, nutzerorientierte Quelle der Anleitung eingefuehrt; je eine
  fuer alle 15 Templates (oeffnen → Inhalte ersetzen → Impressum → PDF).
- gallery_build.py bettet jetzt USAGE.md statt README.md ein. README.md bleibt
  als Maintainer-Dokument erhalten, leakt aber nicht mehr auf die Seite.
- Template-Detailseite blendet die "Anleitung"-Ueberschrift aus, wenn kein
  Anleitungs-Inhalt vorhanden ist.
- Galerie-Inhalte neu generiert.
@flomotlik flomotlik merged commit 279f019 into main Jun 8, 2026
3 checks passed
@flomotlik flomotlik deleted the issue/vorlagen-template-anleitungen-entrumpeln branch June 8, 2026 18:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant