From 771340f3ca8274e905584b5b39239e24a9a87c39 Mon Sep 17 00:00:00 2001 From: Nathan Schepers <3958483+nathanschepers@users.noreply.github.com> Date: Mon, 20 Jul 2026 15:53:09 +0300 Subject: [PATCH] README: state the tag versioning principle Co-Authored-By: Claude Fable 5 --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 37c58d8..a4df7e7 100644 --- a/README.md +++ b/README.md @@ -59,6 +59,14 @@ cd ../my-new-thing && uvx copier update Copier copies from the latest tag; tags are the template's release channel. After generating, run `uv lock`, then work through the generated `SETUP.md`. +Versions track what `copier update` does to a project generated from the previous tag, not the +size of the content change: + +- **patch** — the update replays cleanly: no new questions, changes land inside existing files +- **minor** — the update adds surface: a new question or newly generated files +- **major** — the update needs manual work: a question renamed or removed, answer semantics + changed, or the file layout restructured + ## License Apache-2.0. The license covers this template's own files; projects you generate from it are