From 2ed03dbf05645cc449d674802dc906389552b53c Mon Sep 17 00:00:00 2001
From: Nathan Youngman <git@nathany.com>
Date: Wed, 24 Sep 2014 17:44:47 -0600
Subject: [PATCH] revisions based on @niemeyer's review

---
 README.md  |  2 +-
 version.go | 12 ++++++++----
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 1189193..bcec69b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,3 @@
 # gopkg.in Stable APIs for the Go language
 
-See [http://labix.org/gopkg.in](http://labix.org/gopkg.in).
+See [http://gopkg.in](http://gopkg.in).
diff --git a/version.go b/version.go
index f0e0718..d99cf46 100644
--- a/version.go
+++ b/version.go
@@ -4,7 +4,7 @@ import (
 	"fmt"
 )
 
-// Version is a semantic version number (SemVer).
+// Version represents a version number.
 // An element that is not present is represented as -1.
 type Version struct {
 	Major, Minor, Patch int
@@ -23,7 +23,7 @@ func (v Version) String() string {
 	return fmt.Sprintf("v%d.%d.%d", v.Major, v.Minor, v.Patch)
 }
 
-// Less returns true if v is less than other.
+// Less returns whether v is less than other.
 func (v Version) Less(other Version) bool {
 	if v.Major != other.Major {
 		return v.Major < other.Major
@@ -34,7 +34,12 @@ func (v Version) Less(other Version) bool {
 	return v.Patch < other.Patch
 }
 
-// Contains returns true if other >= v yet below the next major version.
+// Contains returns whether version v contains version other.
+// Version v is defined to contain version other when they both have the same Major
+// version and v.Minor and v.Patch are either undefined or are equal to other's.
+//
+// For example, Version{1, 1, -1} contains both Version{1, 1, -1} and Version{1, 1, 2},
+// but not Version{1, -1, -1} or Version{1, 2, -1}.
 func (v Version) Contains(other Version) bool {
 	if v.Patch != -1 {
 		return v == other
@@ -45,7 +50,6 @@ func (v Version) Contains(other Version) bool {
 	return v.Major == other.Major
 }
 
-// IsValid tests if a version is valid.
 func (v Version) IsValid() bool {
 	return v != InvalidVersion
 }