update README

Author: Dean Karn

README.md

@@ -18,7 +18,7 @@ I initially created [lars](https://github.com/go-playground/lars), which I still
 Key & Unique Features 
 --------------
 - [x] It sticks to Go's native implimentations while providing helper functions for convenience
-- [x] **Fast & Efficient** - pure uses a custom version of [httprouter](https://github.com/julienschmidt/httprouter) so incredibly fast and efficient.
+- [x] **Fast & Efficient** - pure uses a custom version of [httprouter](https://github.com/julienschmidt/httprouter)'s radix tree, so incredibly fast and efficient.
 
 Installation
 -----------
@@ -56,6 +56,15 @@ func helloWorld(w http.ResponseWriter, r *http.Request) {
 }
 ```
 
+RequestVars
+-----------
+This is an interface that is used to pass request scoped variables and functions using `context.Context`.
+It is implimented in this way because retrieving values from `context` isn't the fastest, and so using this 
+the router can store multiple pieces of information while reducing lookup time to a single stored `RequestVars`.
+
+Currently only the URL/SEO params are stored on the `RequestVars` but if/when more is added they can merely be added
+to the `RequestVars` and there will be no additional lookup time.
+
 URL Params
 ----------
 
@@ -66,8 +75,9 @@ p := p.New()
 l.Get("/user/:id", UserHandler)
 
 // extract params like so
-rv := pure.ReqestVars(r) // done this way so only have to extract from context once
-rv.Params().Get(paramname)
+rv := pure.ReqestVars(r) // done this way so only have to extract from context once, read above
+params := rv.Params() or params := pure.ReqestVars(r).Params()
+params.Get(paramname)
 
 // serve css, js etc.. pure.RequestVars(r).Params().Get(pure.WildcardParam) will return the remaining path if 
 // you need to use it in a custom handler...
@@ -76,13 +86,13 @@ l.Get("/static/*", http.FileServer(http.Dir("static/")))
 ...
 ```
 
-**Note:** Since this router has only explicit matches, you can not register static routes and parameters for the same path segment. For example you can not register the patterns /user/new and /user/:user for the same request method at the same time. The routing of different request methods is independent from each other. I was initially against this, and this router allowed it in a previous version, however it nearly cost me in a big app where the dynamic param value say :type actually could have matched another static route and that's just too dangerous, so it is no longer allowed.
+**Note:** Since this router has only explicit matches, you can not register static routes and parameters for the same path segment. For example you can not register the patterns /user/new and /user/:user for the same request method at the same time. The routing of different request methods is independent from each other. I was initially against this, however it nearly cost me in a large web application where the dynamic param value say :type actually could have matched another static route and that's just too dangerous and so it is not allowed.
 
 Groups
 -----
 ```go
 
-p.Use(LoggingAndRecovery)
+p.Use(LoggingAndRecovery, Gzip...)
 ...
 p.Post("/users/add", ...)
 
@@ -92,25 +102,25 @@ user.Get("", ...)
 user.Post("", ...)
 user.Delete("/delete", ...)
 
-contactInfo := user.Group("/contact-info/:ciid")
+contactInfo := user.Group("/contact-info/:cid")
 contactinfo.Delete("/delete", ...)
 
 // creates a group for others + inherits all middleware registered using p.Use() + adds 
 // OtherHandler to middleware
 others := p.Group("/others", OtherHandler)
 
 // creates a group for admin WITH NO MIDDLEWARE... more can be added using admin.Use()
-admin := p.Group("/admin",nil)
+admin := p.Group("/admin", nil)
 admin.Use(SomeAdminSecurityMiddleware)
 ...
 ```
 
 Decoding Body
 -------------
-currently JSON, XML, FORM + Multipart Form's are support out of the box.
+currently JSON, XML, FORM, Multipart Form and url.Values are support out of the box.
 ```go
 	// second argument denotes yes or no I would like URL query parameter fields
-	// to be included. i.e. 'id' in route '/user?id=val' should it be included.
+	// to be included. i.e. 'id' and 'id2' in route '/user/:id?id2=val' should it be included.
 	if err := pure.Decode(r, true, maxBytes, &user); err != nil {
 		log.Println(err)
 	}
@@ -142,15 +152,13 @@ comply with the following rule(s):
 
 * Are completely reusable by the community without modification
 
-Other middleware will be listed under the examples/middleware/... folder for a quick copy/paste modify. as an example a logging or
-recovery middleware are very application dependent and therefore will be listed under the examples/middleware/...
+Other middleware will be listed under the examples/middleware/... folder for a quick copy/paste modify. As an example a LoddingAndRecovery middleware is very application dependent and therefore will be listed under the examples/middleware/...
 
 Benchmarks
 -----------
-Run on MacBook Pro (Retina, 15-inch, Late 2013) 2.6 GHz Intel Core i7 16 GB 1600 MHz DDR3 using Go version go1.7.1 darwin/amd64
+Run on MacBook Pro (Retina, 15-inch, Late 2013) 2.6 GHz Intel Core i7 16 GB 1600 MHz DDR3 using Go version go1.7.3 darwin/amd64
 
-NOTICE: pure uses a custom version of [httprouter](https://github.com/julienschmidt/httprouter), benchmarks can be found [here](https://github.com/joeybloggs/go-http-routing-benchmark/tree/pure-and-lars)
-the slowdown is with the use of the `context` package, as you can see when no params, and therefore no need to store anything in the context, it is faster than even lars.
+NOTICE: pure uses a custom version of [httprouter](https://github.com/julienschmidt/httprouter)'s radix tree, benchmarks can be found [here](https://github.com/joeybloggs/go-http-routing-benchmark/tree/pure-and-lars) the slowdown is with the use of the `context` package, as you can see when no SEO params are defined, and therefore no need to store anything in the context, it is faster than even lars.
 
 ```go
 go test -bench=. -benchmem=true
@@ -193,6 +201,8 @@ Why? because my time is spread pretty thin maintaining all of the libraries I ha
 it is so freeing not to worry about it and will help me keep pouring out bigger and better
 things for you the community.
 
+I am open versioning with gopkg.in should anyone request it, but this should be stable going forward.
+
 Licenses
 --------
 - [MIT License](https://raw.githubusercontent.com/go-playground/pure/master/LICENSE) (MIT), Copyright (c) 2016 Dean Karn