diff --git a/changelog.md b/changelog.md
index 54b920bdf..f43b3fe7f 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,3 +1,10 @@
+
+3.5.8.2
+=======
+-@jappeace
+    - [#346](https://github.com/bitemyapp/esqueleto/pull/346)
+       - Add docs for boolean operators
+
 3.5.8.1
 =======
 - @belevy
diff --git a/esqueleto.cabal b/esqueleto.cabal
index 8cae86d18..93a0b51c0 100644
--- a/esqueleto.cabal
+++ b/esqueleto.cabal
@@ -2,7 +2,7 @@ cabal-version: 1.12
 
 name:           esqueleto
 
-version:        3.5.8.1
+version:        3.5.8.2
 synopsis:       Type-safe EDSL for SQL queries on persistent backends.
 description:    @esqueleto@ is a bare bones, type-safe EDSL for SQL queries that works with unmodified @persistent@ SQL backends.  Its language closely resembles SQL, so you don't have to learn new concepts, just new syntax, and it's fairly easy to predict the generated SQL and optimize it for your backend. Most kinds of errors committed when writing SQL are caught as compile-time errors---although it is possible to write type-checked @esqueleto@ queries that fail at runtime.
                 .
diff --git a/src/Database/Esqueleto/Internal/Internal.hs b/src/Database/Esqueleto/Internal/Internal.hs
index bf70f8f2c..94255dff2 100644
--- a/src/Database/Esqueleto/Internal/Internal.hs
+++ b/src/Database/Esqueleto/Internal/Internal.hs
@@ -697,26 +697,33 @@ not_ v = ERaw noMeta $ \p info -> first ("NOT " <>) $ x p info
                     let (b, vals) = f Never info
                     in (parensM p b, vals)
 
+-- | @==@, for in a where expression for example.
 (==.) :: PersistField typ => SqlExpr (Value typ) -> SqlExpr (Value typ) -> SqlExpr (Value Bool)
 (==.) = unsafeSqlBinOpComposite " = " " AND "
 
+-- | @>=@, for in a where expression for example.
 (>=.) :: PersistField typ => SqlExpr (Value typ) -> SqlExpr (Value typ) -> SqlExpr (Value Bool)
 (>=.) = unsafeSqlBinOp " >= "
 
+-- | @>@, for in a where expression for example.
 (>.)  :: PersistField typ => SqlExpr (Value typ) -> SqlExpr (Value typ) -> SqlExpr (Value Bool)
 (>.)  = unsafeSqlBinOp " > "
 
+-- | @<=@, for in a where expression for example.
 (<=.) :: PersistField typ => SqlExpr (Value typ) -> SqlExpr (Value typ) -> SqlExpr (Value Bool)
 (<=.) = unsafeSqlBinOp " <= "
 
+-- | @<@, for in a where expression for example.
 (<.)  :: PersistField typ => SqlExpr (Value typ) -> SqlExpr (Value typ) -> SqlExpr (Value Bool)
 (<.)  = unsafeSqlBinOp " < "
 (!=.) :: PersistField typ => SqlExpr (Value typ) -> SqlExpr (Value typ) -> SqlExpr (Value Bool)
 (!=.) = unsafeSqlBinOpComposite " != " " OR "
 
+-- | @AND@, for in a where expression for example.
 (&&.) :: SqlExpr (Value Bool) -> SqlExpr (Value Bool) -> SqlExpr (Value Bool)
 (&&.) = unsafeSqlBinOp " AND "
 
+-- | @OR@, for in a where expression for example.
 (||.) :: SqlExpr (Value Bool) -> SqlExpr (Value Bool) -> SqlExpr (Value Bool)
 (||.) = unsafeSqlBinOp " OR "