From 4ec3949a9c2c43dd1f1c3477421d9f17224ce43e Mon Sep 17 00:00:00 2001
From: Leonel Quinteros <leonel.quinteros@gmail.com>
Date: Fri, 1 Jul 2016 12:40:59 -0300
Subject: [PATCH] Improved readme docs

---
 README.md | 36 +++++++++++++++++++++++++++++++-----
 1 file changed, 31 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 22731f9..11d26ec 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 GNU gettext utilities for Go. 
 
-Version: [1.0.1](https://github.com/leonelquinteros/gotext/releases/tag/v1.0.1)
+Version: [v1.0.1](https://github.com/leonelquinteros/gotext/releases/tag/v1.0.1)
 
 
 # Features
@@ -21,6 +21,16 @@ Version: [1.0.1](https://github.com/leonelquinteros/gotext/releases/tag/v1.0.1)
 - Ready to use inside Go templates.
 
 
+# License
+
+[MIT license](LICENSE)
+
+
+# Documentation
+
+Refer to the Godoc package documentation at (https://godoc.org/github.com/leonelquinteros/gotext)
+
+
 # Installation 
 
 ```
@@ -32,14 +42,30 @@ go get github.com/leonelquinteros/gotext
 - No need for environment variables. Some naming conventions are applied but not needed.  
 
 
-# License
+### Version vendoring
 
-[MIT license](LICENSE)
+Stable releases use [semantic versioning](http://semver.org/spec/v2.0.0.html) tagging on this repository.
+
+You can rely on this to use your preferred vendoring tool or to manually retrieve the corresponding release tag from the GitHub repository.
 
 
-# Documentation
+### Vendoring with [gopkg.in](http://labix.org/gopkg.in) (optional)
 
-Refer to the Godoc package documentation at (https://godoc.org/github.com/leonelquinteros/gotext)
+(http://gopkg.in/leonelquinteros/gotext.v1)
+
+To get the latest v1 package stable release, execute:
+
+```
+go get gopkg.in/leonelquinteros/gotext.v1
+```
+
+To import this package, add the following line to your code:
+
+```go
+import "gopkg.in/leonelquinteros/gotext.v1"
+```
+
+Refer to it as gotext.
 
 
 # Locales directories structure