diff --git a/README.md b/README.md index ea404819..cf244b04 100644 --- a/README.md +++ b/README.md @@ -101,7 +101,8 @@ If you are developing on Windows with TCP connections: ## Version Policy -pgx follows semantic versioning for the documented public API. ```master``` -branch tracks the latest stable branch (```v2```). Consider using ```import -"gopkg.in/jackc/pgx.v2"``` to lock to the ```v2``` branch or use a vendoring -tool such as [godep](https://github.com/tools/godep). +pgx follows semantic versioning for the documented public API on stable releases. Branch ```v2``` is the latest stable release. ```master``` can contain new features or behavior that will change or be removed before being merged to the stable ```v2``` branch (in practice, this occurs very rarely). + +Consider using a vendoring +tool such as [godep](https://github.com/tools/godep) or importing pgx via ```import +"gopkg.in/jackc/pgx.v2"``` to lock to the ```v2``` branch.