Web Developer

|

Stockholm, Sweden

Delivering scalable solutions for
startups, enterprises, and agencies.

Semantic Versioning with Git Tags

What is Semantic Versioning?

Semantic versioning (SemVer) is a three-part numbering system: MAJOR.MINOR.PATCH. Each number tells you exactly what changed and whether it'll break your code.

The Format Breakdown

  • MAJOR - Incompatible changes that will break existing code
  • MINOR - New features that won't break anything
  • PATCH - Bug fixes only
Example: Version 2.1.3 means 2 major breaking changes, 1 new feature added, and 3 bug fixes since the last minor release.

Why Use It?

  • Instant clarity - Anyone can tell the impact of an update at a glance
  • Safe updates - Know if upgrading will break your project
  • Team communication - Universal language for discussing changes

Implementation with Git Tags

  • Commit your changes: git commit -m "Add user authentication"
  • Tag the version: git tag -a v1.2.0 -m "Add authentication feature"
  • Push tags: git push origin main --tags

Quick npm Automation

For npm projects, automate the whole process:

npm version minor - Updates package.json and creates a Git tag automatically

Regarding your portfolio question:

This is actually perfect for a portfolio. Here's why:

  1. It's fundamental knowledge that many developers don't fully grasp
  2. Shows you understand professional workflows - versioning is crucial in real development
  3. Demonstrates clear communication skills - explaining technical concepts simply is valuable
  4. It's practical - employers want developers who understand release management

Far from looking junior, this shows you understand the bigger picture of software development beyond just writing code. Keep it!

Web Developer
Harry Yates 2025®