Merge branch 'hotfix/0.1.4'

README.md

@@ -18,6 +18,14 @@ A tags package for use with Go (golang) services
 - All strict Tags applied with logical operator "AND" between each other
 - All non-strict Tags applied with logical operator "OR" between all tags
 
+### Queries
+
+{"a","b"} this mean that we ask "a" OR "b" tag
+
+{"a","+b","+c"} this mean that we ask "a" OR ("b" AND "c") tag
+
+{"a","+b", "c", "-d"} this mean that we ask "a" OR "c" OR ("b" AND NOT "d") tag
+
 ### Example
 
 ```go
@@ -45,6 +53,7 @@ func main() {
 
 	fmt.Println("Product:", product.Description)
 
+	// We ask for any tee "black" or "green"
 	fmt.Println("Is this tee black or green?")
 	query := tags.Tags{"black", "green"}
 
@@ -54,6 +63,7 @@ func main() {
 		fmt.Println("No, the tee has not black or green options.")
 	}
 
+	// We ask fot strict match "green" and "sugar"
 	fmt.Println("Is this tee green with sugar?")
 	query = tags.Tags{"+green", "+sugar"}
 
@@ -63,6 +73,7 @@ func main() {
 		fmt.Println("No, the tee with sugar, but is not green.")
 	}
 
+	// We ask for strict mismatch, not "ice"
 	fmt.Println("Is this tee hot?")
 	query = tags.Tags{"-ice"}
 

example/example.go

@@ -22,6 +22,7 @@ func main() {
 
 	fmt.Println("Product:", product.Description)
 
+	// We ask for any tee "black" or "green"
 	fmt.Println("Is this tee black or green?")
 	query := tags.Tags{"black", "green"}
 
@@ -31,6 +32,7 @@ func main() {
 		fmt.Println("No, the tee has not black or green options.")
 	}
 
+	// We ask fot strict match "green" and "sugar"
 	fmt.Println("Is this tee green with sugar?")
 	query = tags.Tags{"+green", "+sugar"}
 
@@ -40,6 +42,7 @@ func main() {
 		fmt.Println("No, the tee with sugar, but is not green.")
 	}
 
+	// We ask for strict mismatch, not "ice"
 	fmt.Println("Is this tee hot?")
 	query = tags.Tags{"-ice"}
 

tags.go

@@ -3,7 +3,7 @@
 // that can be found in the LICENSE file.
 
 /*
-Package tags 0.1.3
+Package tags 0.1.4
 
 Definition:
 
@@ -17,6 +17,12 @@ Rules:
 	- All strict Tags applied with logical operator "AND" between each other
 	- All non-strict Tags applied with logical operator "OR" between all tags
 
+Queries:
+
+	{"a","b"} this mean that we ask "a" OR "b" tag
+	{"a","+b","+c"} this mean that we ask "a" OR ("b" AND "c") tag
+	{"a","+b", "c", "-d"} this mean that we ask "a" OR "c" OR ("b" AND NOT "d") tag
+
 Example:
 
 	package main
@@ -43,6 +49,7 @@ Example:
 
 		fmt.Println("Product:", product.Description)
 
+		// We ask for any tee "black" or "green"
 		fmt.Println("Is this tee black or green?")
 		query := tags.Tags{"black", "green"}
 
@@ -52,6 +59,7 @@ Example:
 			fmt.Println("No, the tee has not black or green options.")
 		}
 
+		// We ask fot strict match "green" and "sugar"
 		fmt.Println("Is this tee green with sugar?")
 		query = tags.Tags{"+green", "+sugar"}
 
@@ -61,6 +69,7 @@ Example:
 			fmt.Println("No, the tee with sugar, but is not green.")
 		}
 
+		// We ask for strict mismatch, not "ice"
 		fmt.Println("Is this tee hot?")
 		query = tags.Tags{"-ice"}