diff --git a/Data/Conduit/Internal/Conduit.hs b/Data/Conduit/Internal/Conduit.hs
--- a/Data/Conduit/Internal/Conduit.hs
+++ b/Data/Conduit/Internal/Conduit.hs
@@ -722,15 +722,7 @@
     return res
 {-# INLINE [1] ($$) #-}
 
--- | Left fuse, combining a source and a conduit together into a new source.
---
--- Both the @Source@ and @Conduit@ will be closed when the newly-created
--- @Source@ is closed.
---
--- Leftover data from the @Conduit@ will be discarded.
---
--- Note: Since version 1.0.18, this operator has been generalized to be
--- identical to @=$=@.
+-- | A synonym for '=$=' for backwards compatibility.
 --
 -- Since 0.4.0
 ($=) :: Monad m => Conduit a m b -> ConduitM b c m r -> ConduitM a c m r
@@ -738,15 +730,7 @@
 {-# INLINE [0] ($=) #-}
 {-# RULES "conduit: $= is =$=" ($=) = (=$=) #-}
 
--- | Right fuse, combining a conduit and a sink together into a new sink.
---
--- Both the @Conduit@ and @Sink@ will be closed when the newly-created @Sink@
--- is closed.
---
--- Leftover data returned from the @Sink@ will be discarded.
---
--- Note: Since version 1.0.18, this operator has been generalized to be
--- identical to @=$=@.
+-- | A synonym for '=$=' for backwards compatibility.
 --
 -- Since 0.4.0
 (=$) :: Monad m => Conduit a m b -> ConduitM b c m r -> ConduitM a c m r
@@ -787,7 +771,8 @@
 {-# INLINE [1] (=$=) #-}
 
 -- | Wait for a single input value from upstream. If no data is available,
--- returns @Nothing@.
+-- returns @Nothing@. Once @await@ returns @Nothing@, subsequent calls will
+-- also return @Nothing@.
 --
 -- Since 0.5.0
 await :: Monad m => Consumer i m (Maybe i)
@@ -1062,6 +1047,12 @@
 -- Note that the standard 'Applicative' instance for conduits works
 -- differently. It feeds one sink with input until it finishes, then switches
 -- to another, etc., and at the end combines their results.
+--
+-- This newtype is in fact a type constrained version of 'ZipConduit', and has
+-- the same behavior. It's presented as a separate type since (1) it
+-- historically predates @ZipConduit@, and (2) the type constraining can make
+-- your code clearer (and thereby make your error messages more easily
+-- understood).
 --
 -- Since 1.0.13
 newtype ZipSink i m r = ZipSink { getZipSink :: Sink i m r }
diff --git a/Data/Conduit/List.hs b/Data/Conduit/List.hs
--- a/Data/Conduit/List.hs
+++ b/Data/Conduit/List.hs
@@ -534,7 +534,8 @@
 scanlM f s = void $ mapAccumM f s
 {-# DEPRECATED scanlM "Use mapAccumM instead" #-}
 
--- | Analog of @mapAccumL@ for lists.
+-- | Analog of @mapAccumL@ for lists. Note that in contrast to @mapAccumL@, the function argument
+--   takes the accumulator as its second argument, not its first argument.
 --
 -- Subject to fusion
 --
diff --git a/changelog.md b/changelog.md
--- a/changelog.md
+++ b/changelog.md
@@ -1,3 +1,7 @@
+## 1.2.4.1
+
+* Some documentation improvements
+
 ## 1.2.4
 
 * [fuseBothMaybe](https://github.com/snoyberg/conduit/issues/199)
diff --git a/conduit.cabal b/conduit.cabal
--- a/conduit.cabal
+++ b/conduit.cabal
@@ -1,5 +1,5 @@
 Name:                conduit
-Version:             1.2.4
+Version:             1.2.4.1
 Synopsis:            Streaming data processing library.
 description:
     Hackage documentation generation is not reliable. For up to date documentation, please see: <http://www.stackage.org/package/conduit>.