diff --git a/fuzzyset.cabal b/fuzzyset.cabal
--- a/fuzzyset.cabal
+++ b/fuzzyset.cabal
@@ -1,13 +1,13 @@
 cabal-version: 1.12
 
--- This file has been generated from package.yaml by hpack version 0.31.2.
+-- This file has been generated from package.yaml by hpack version 0.33.0.
 --
 -- see: https://github.com/sol/hpack
 --
--- hash: ca8c7475d857875ca00bad57120016509b82a9a1cf5d1e68c77389188fbf0096
+-- hash: 6ee7bf1a1bbd5929c3e9797fb599ae6dfc5b700c9690e00d71eaf65e523fa965
 
 name:           fuzzyset
-version:        0.2.0
+version:        0.2.1
 synopsis:       Fuzzy set for approximate string matching
 description:    This library is based on the Python and JavaScript libraries with similar names.
 category:       Data
@@ -53,7 +53,7 @@
       base >=4.7 && <5
     , data-default >=0.7.1.1 && <0.8
     , fuzzyset
-    , hspec >=2.7.1 && <2.8
+    , hspec >=2.7.1 && <2.9
     , ieee754 >=0.8.0 && <0.9
     , text >=1.2.3.1 && <1.3
     , text-metrics >=0.3.0 && <0.4
diff --git a/src/Data/FuzzySet.hs b/src/Data/FuzzySet.hs
--- a/src/Data/FuzzySet.hs
+++ b/src/Data/FuzzySet.hs
@@ -149,8 +149,9 @@
 --
 -- where \(A \cdot B\) is the dot product of the two vectors, and \(||A||\)
 -- denotes the [euclidean norm](Data-FuzzySet-Util.html#v:norm), or /magnitude/,
--- of \(A\). Since the cosine similarity is a measure of the (cosine of the)
--- angle between two vectors, it is always in the range \([0, 1]\).
+-- of \(A\). The cosine similarity is a measure of the (cosine of the) angle
+-- between two vectors. Since we will only deal with vectors with non-negative
+-- components, the result of this operation is always in the range \([0, 1]\).
 --
 -- == Gram vectors
 --
@@ -211,7 +212,7 @@
 -- Dotting these we get \(1 \times 1 + 1 \times 1 + 1 \times 2 + 1 \times 1 = 5 \).
 -- The function 'matches' computes these dot products and returns a dictionary
 -- with the matched indices as keys. If the entry appears at item index, say,
--- 3 in the set's internal list, this would yield a key-value pair @3 => 5@ in
+-- 3 in the set's internal list, this would yield a key-value pair @(3, 5)@ in
 -- the map.
 --
 -- >>> matches (defaultSet `add` "tea" `add` "biscuits" `add` "cake" `add` "coffee") (gramVector "covfefe" 2)