From 026834f83e862e91c3bf9aa9c02fb484d79628ad Mon Sep 17 00:00:00 2001 From: Matteo Prandi Date: Thu, 9 Apr 2026 17:27:40 +0200 Subject: [PATCH] docs(readme): clarify branch model --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9af80a8..8ef8c4e 100644 --- a/README.md +++ b/README.md @@ -221,8 +221,11 @@ This repo now includes: Contribution flow: -- `main` stays stable -- contributions should branch from `dev` and open PRs back into `dev` +- `main` is the stable public default branch +- GitHub releases and release tags should be cut from `main` +- `dev` is the integration branch for ongoing work +- feature branches should usually branch from `dev` and open PRs back into `dev` +- promote `dev` into `main` when the integrated state is ready to become the new public baseline ## Repository Shape