git ready > tagging

So, how does one create a tag? Just git tag v1.0.0 right? WRONG. You usually don%u2019t want to do that. In fact, some suggest that this command does the wrong thing by default. Without arguments, git tag creates a %u201Clightweight%u201D tag that is basically a branch that never moves. Lightweight tags are still useful though, perhaps for marking a known good (or bad) version, or a bunch of commits you may need to use in the future. Nevertheless, you probably don%u2019t want to push these kinds of tags.

Normally, you want to at least pass the -a option to create an unsigned tag, or sign the tag with your GPG key via the -s or -u options. Once this has been done you can then use git describe to figure out how many commits you%u2019ve created since the last tag or the given tag. Git-fu has a great tutorial on how to use this command (and it deserves a tip of its own for the future too!).

$ git tag -a v1.0.0 -m "Creating the first official version."