update docs

README.md

@@ -5,7 +5,7 @@
 [![GoDoc](https://godoc.org/github.com/da440dil/go-counter?status.svg)](https://godoc.org/github.com/da440dil/go-counter)
 [![Go Report Card](https://goreportcard.com/badge/github.com/da440dil/go-counter)](https://goreportcard.com/report/github.com/da440dil/go-counter)
 
-Distributed rate limiting with pluggable storage to store a counters state.
+Distributed rate limiting with pluggable storage for storing a counters state.
 
 ## Basic usage
 
@@ -21,7 +21,7 @@ if v, err := c.Count("key"); err != nil {
 	}
 } else {
 	// Counter value equals 1
-	// Remainder (v) equals 0
+	// Remainder value (v) equals 0
 	// Next c.Count("key") call will return TTLError
 }
 ```

gateway/memory/memory.go

@@ -7,7 +7,7 @@ import (
 	"time"
 )
 
-// Gateway is a gateway to memory storage.
+// Gateway to memory storage.
 type Gateway struct {
 	*storage
 }
@@ -18,10 +18,7 @@ func New(cleanupInterval time.Duration) *Gateway {
 		items:   make(map[string]*item),
 		cleaner: newCleaner(cleanupInterval),
 	}
-	// This trick ensures that cleanup goroutine does not keep
-	// the returned Gateway from being garbage collected.
-	// When it is garbage collected, the finalizer stops cleanup goroutine,
-	// after which storage can be collected.
+	// See https://gist.github.com/da440dil/6469a37e649a560f528fd116fa2e874d
 	gw := &Gateway{s}
 	go s.cleaner.Run(s.deleteExpired)
 	runtime.SetFinalizer(gw, finalizer)

gateway/redis/redis.go

@@ -27,7 +27,7 @@ var incr = redis.NewScript(
 		"return {v, t}",
 )
 
-// Gateway is a gateway to Redis storage.
+// Gateway to Redis storage.
 type Gateway struct {
 	client *redis.Client
 }