Files
werkbaum/docs/prs
mhoennigandClaude Opus 5 c87cf6212d
Deploy to GitHub Pages / build (push) Canceled after 0s
Deploy to GitHub Pages / deploy (push) Canceled after 0s
docs(prs): PR-doc auf Nummer 3 — 1 und 2 gehören der GitHub-Historie
Gitea begann nach dem Umzug wieder bei 1, Werkbaums Historie kennt aber
schon GitHub-PR #1 und #2. Beide Nummern sind in Gitea abgebrannt; die
Zählung setzt bei 3 auf, damit eine Nummer in docs/prs/ eindeutig bleibt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-03 19:26:31 +02:00
..

PR-Dokumentation

Jeder Pull Request bekommt hier eine Datei.

Dateiname

JJJJ-MM-TT-PR#<nummer>-kurze-beschreibung.md

Die Nummer ist die des Gitea-PR auf https://git.javagil.de/mi/werkbaum. Gitea begann nach dem Umzug (D95) wieder bei 1, während die Historie schon GitHub-PR #1 und #2 kennt; die Nummern 1 und 2 sind deshalb abgebrannt und die Zählung setzt bei #3 auf. Steht sie noch nicht fest, gilt PR#000 als Platzhalter — im Dateinamen wie in den Szenario-IDs — und wird nachgezogen, sobald der PR offen ist.

Aufbau

Die ##-Abschnitte in genau dieser Reihenfolge, nicht Zutreffendes weglassen:

  1. Das Problem
  2. Nicht das Ziel
  3. Die Szenarien
  4. Die Lösung
  5. Offene Fragen
  6. Weitere Änderungen
  7. Vorausgesetzte PRs
  8. Folge-PRs

Regeln

  • Deutsch (CLAUDE.md), Markdown, ein Satz je Zeile, kurz halten.
  • Das „Warum“ erklären, nicht nur das „Was“.
  • Szenarien in Markdown-eigenem Pseudo-Gherkin mit IDs Szenario#<pr-nummer>.<nn>, jedes mit einer Liste ##### Nachgewiesen durch.
  • Ein PR-doc beschreibt den Stand dieses PR. Ältere PR-docs werden nicht nachgepflegt, wenn spätere PRs das Verhalten ändern — dauerhafte Begründungen gehören nach docs/DECISIONS.md.