@@ -269,10 +269,11 @@ eitherDecode' = eitherDecodeWith json' fromJSON
269269-- $pitfalls
270270-- #pitfalls#
271271--
272−-- Note that the JSON standard that the top-level be either an array
273−-- or an object. Since this library follows the standard, calling
274−-- 'decode' on an unsupported result type will typecheck, but will
275−-- always \"fail\":
272+-- Note that the JSON standard requires that the top-level value be
273+-- either an array or an object. If you try to use 'decode' with a
274+-- result type that is /not/ represented in JSON as an array or
275+-- object, your code will typecheck, but it will always \"fail\" at
276+-- runtime:
276277--
277278-- > >>> decode "1" :: Maybe Int
278279-- > Nothing