MEPX
Chapter 13 of 14All chapters
  1. 1What Git is
  2. 2The three places
  3. 3Committing
  4. 4History and diffs
  5. 5Branches
  6. 6Merging
  7. 7Conflicts
  8. 8Remotes
  9. 9Fetch, pull and push
  10. 10Undoing work
  11. 11Stashing
  12. 12Ignoring files
  13. 13Tags and releases
  14. 14Working with others

Chapter 13 of 14

Tags and releases

Marking a commit worth naming.

Tagging

A tag is a label on one commit that does not move. git tag -a v1.0 -m "first release" creates an annotated tag with an author and a date, which is the kind to use for releases.

  • Tags are not pushed by default: git push origin v1.0 sends one.
  • git describe names the current commit relative to the last tag.

Versions

Most projects follow semantic versioning: major for breaking changes, minor for new features, patch for fixes. The tag is what release tooling and package managers read.