diff --git a/COLLABORATING.md b/COLLABORATING.md index 45cd6984..871d70a9 100644 --- a/COLLABORATING.md +++ b/COLLABORATING.md @@ -56,6 +56,30 @@ Examples: - `needs-discussion` — decision needed before work starts - `wontfix` — acknowledged, not addressing +## Branching and Pull Requests + +All changes go through a branch and a pull request — never commit directly to `main`. + +### Branch naming + +``` +/ +``` + +Examples: +- `feat/received-documents-person-page` +- `fix/tag-filter-url-sync` +- `devops/docker-compose-v2` + +### Workflow + +1. Create a branch from `main` before writing any code. +2. Commit work to that branch. +3. Open a pull request on Gitea targeting `main` for review. +4. Wait for approval before merging. + +The PR description should reference the related issue (`Closes #n` or `Refs #n`). + ## Commit Messages Every commit must reference the relevant Gitea issue.