@@ -269,10 +269,11 @@ eitherDecode' = eitherDecodeWith json' fromJSON
269-- $pitfalls
269-- $pitfalls
270-- #pitfalls#
270-- #pitfalls#
272−-- Note that the JSON standard that the top-level be either an array
272+-- Note that the JSON standard requires that the top-level value be
273−-- or an object. Since this library follows the standard, calling
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
274−-- 'decode' on an unsupported result type will typecheck, but will
275+-- object, your code will typecheck, but it will always \"fail\" at
275−-- always \"fail\":
276+-- runtime:
277-- > >>> decode "1" :: Maybe Int
278-- > >>> decode "1" :: Maybe Int
278-- > Nothing
279-- > Nothing