Skip to main content

TAGGING

# Skyfeed Tagging & Versioning Policy

**Branch:** `master` (primary branch — no `main`)

## Version Format
vMAJOR.MINOR.PATCH[-devN|-betaN]

### Examples
- `v0.1.0-dev1` → first development build for v0.1.0  
- `v0.1.0-dev2` → second dev iteration  
- `v0.1.0-beta1` → pre-release for testing  
- `v0.1.0` → stable tagged release  

### Rules
- Increment **PATCH** for small fixes or cleanup.  
- Increment **MINOR** for added features.  
- Increment **MAJOR** for breaking changes or major re-architecture.  
- Every push that meaningfully changes behavior should get a new `-devN` tag.  
- Tags are always annotated (with `-a`), containing a descriptive changelog message.  

### Commands
```bash
git add .
git commit -m "Describe change"
git tag -a v0.1.0-dev2 -m "Second dev build: IP resolver refactor"
git push && git push origin v0.1.0-dev2