~juju-qa/ubuntu/xenial/juju/xenial-2.0-beta3

# log15's release strategy

 

log15 uses gopkg.in to manage versioning releases so that consumers who don't vendor dependencies can rely upon a stable API.

 

## Master

 

Master is considered to have no API stability guarantee, so merging new code that passes tests into master is always okay.

 

## Releasing a new API-compatible version

 

The process to release a new API-compatible version is described below. For the purposes of this example, we'll assume you're trying to release a new version of v2

 

1. `git checkout v2`

1. `git merge master`

1. Audit the code for any imports of sub-packages. Modify any import references from `github.com/inconshrevealbe/log15/<pkg>` -> `gopkg.in/inconshreveable/log15.v2/<pkg>`

1. `git commit`

1. `git tag`, find the latest tag of the style v2.X.

1. `git tag v2.X+1` If the last version was v2.6, you would run `git tag v2.7`

1. `git push --tags git@github.com:inconshreveable/log15.git v2`