Niall Douglas wrote:
... I just needed to unload the above, and I appreciate that the docs do not sufficiently get into the universal error handling framework part of Outcome. That is due to repeated Reddit feedback telling me that earlier editions of the docs didn't make sense, and I needed to go much slower and hold the hand, so you got the current tutorial which as you've already observed, is too long as it is.
For what it's worth, I found the docs understandable and useful. (Although
the reference is a bit unwieldy, for a number of reasons.) If you could drop
the remaining mentions of the word "monad" and any of its derivatives, it'd
be even better. :-)
Your first iteration was full of monad this and monad that, and embedded
programmers who just want to return an error from a function are not very
interested in monads.
Taking a step back to the part of the message I snipped, the problem with
expected