Note (in docu) that Json.Decode.succeed may fail?

[jvoigtlaender]

The current documentation says (http://package.elm-lang.org/packages/elm-lang/core/4.0.1/Json-Decode#succeed):

A decoder that always succeeds.

But actually, this should be preconditioned on the input being valid JSON. Already something simple as an empty string as input can make the decoder fail. That's non-obvious and has led to confusion, see here and here (and also in the more distant past).

Maybe warn about this in some way in the documentation, since the current wording "always succeeds" does raise wrong expectations?

[jvoigtlaender]

Is addressed in the new documentation.

[jvoigtlaender]

Is addressed in the new documentation.