GIT / A CONCEPT NOTE
Tags & Releases
pinning a moment in history
Overview · mechanism
pitfall · examples
01 / THE SHORT VERSION
The idea in a few sentences.
A git tag is an immutable reference pointer pointing to a specific commit. Unlike branches which move as you commit, tags stay pinned to mark release versions (v1.0.0).
02 / FOLLOW THE MECHANISM
How a release tag works
Stable commit
final release commits are merged to master branch.
Tag create
runs git tag v1.0.0 COMMIT_SHA.
Push tags
pushes tags up to remote repo via git push --tags.
CI Trigger
GitHub Actions detects tag push, automatically building release assets.
04 / COMMAND NOTES
Read the command, then the result.
Inspect the flags and arguments before trying an example. Snippets can need local setup, replacement values, or resources in your own environment.
list all tags in the repository
git tagpush a tag to the remote repository
git push origin v1.0.005 / CHECK YOURSELF
Could you explain Tags & Releases to a teammate?
Try it out loud in two sentences: what it is, and the one detail that changes the picture. If you stall, the gap is the part to reread.
Up next in Git & collaborationThe Refloggit's undo button