S-00-d · Contributor workflow: issue/PR templates, git-cliff, CHANGELOG #31

Closed
opened 2026-06-03 11:28:55 +00:00 by eho · 0 comments
Owner

Outcome: Issue templates (slice/bug/adr-proposal), a PR template enforcing the DoD checklist, a git-cliff config producing an (empty) CHANGELOG.md, and docs/gitea-workflow.md.

Acceptance:

  • .gitea/ISSUE_TEMPLATE/{slice,bug,adr-proposal}.md and .gitea/PULL_REQUEST_TEMPLATE.md present; opening a new issue offers the templates.
  • cliff.toml present; git-cliff generates CHANGELOG.md.
  • docs/gitea-workflow.md documents the issue → milestone → PR flow.

Touches: .gitea/ISSUE_TEMPLATE/, .gitea/PULL_REQUEST_TEMPLATE.md, cliff.toml, CHANGELOG.md, docs/gitea-workflow.md.

Out of scope: app code.

Definition of Done

  • A linked Gitea issue exists (this one).
  • Failing test written and committed first.
  • Implementation makes the test pass.
  • Refactor commit follows if structure improved.
  • Conventional Commit messages referencing this issue (refs #NN).
  • All Gitea Actions CI jobs green.
  • docker compose up from a fresh clone reaches green health checks within 3 minutes.
  • Docs touched if behaviour, contracts, or operations changed.
  • ADR added in docs/architecture/ if a non-obvious decision was made.
  • This issue closed by the merging PR (closes #NN).

Split from #1 (S-00) per CLAUDE.md §13.

**Outcome:** Issue templates (`slice`/`bug`/`adr-proposal`), a PR template enforcing the DoD checklist, a `git-cliff` config producing an (empty) `CHANGELOG.md`, and `docs/gitea-workflow.md`. **Acceptance:** - `.gitea/ISSUE_TEMPLATE/{slice,bug,adr-proposal}.md` and `.gitea/PULL_REQUEST_TEMPLATE.md` present; opening a new issue offers the templates. - `cliff.toml` present; `git-cliff` generates `CHANGELOG.md`. - `docs/gitea-workflow.md` documents the issue → milestone → PR flow. **Touches:** `.gitea/ISSUE_TEMPLATE/`, `.gitea/PULL_REQUEST_TEMPLATE.md`, `cliff.toml`, `CHANGELOG.md`, `docs/gitea-workflow.md`. **Out of scope:** app code. ## Definition of Done - [ ] A linked Gitea issue exists (this one). - [ ] Failing test written and committed first. - [ ] Implementation makes the test pass. - [ ] Refactor commit follows if structure improved. - [ ] Conventional Commit messages referencing this issue (`refs #NN`). - [ ] All Gitea Actions CI jobs green. - [ ] `docker compose up` from a fresh clone reaches green health checks within 3 minutes. - [ ] Docs touched if behaviour, contracts, or operations changed. - [ ] ADR added in `docs/architecture/` if a non-obvious decision was made. - [ ] This issue closed by the merging PR (`closes #NN`). _Split from #1 (S-00) per CLAUDE.md §13._
eho added this to the Iteration 0 — Foundations milestone 2026-06-03 11:28:55 +00:00
eho added the type:slicearea:infraarea:docs labels 2026-06-03 11:28:55 +00:00
eho closed this issue 2026-06-03 12:09:25 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: eho/register-referentie#31