On 11 Nov 2016 at 17:36, Steve M. Robbins wrote:
To that end, I've written an explanation and a sort of tutorial explaining the history and purpose of Outcome at https://ned14.github.io/boost.outcome/ and I'd greatly appreciate if people could tell me:
1. Does it make sense?
I really liked the initial history of error handling design patterns -- it was clear and I appreciated seeing the same running example through the different design approaches.
Cool.
However, when it came to "Introducing Outcome", it no longer felt like an introduction. I was expecting another iteration of the running example using the new library but instead was dropped deep into a design comparison with "Expected". Not knowing anything about the design of Expected, this is where I stopped reading. I skimmed to the end, but essentially understood nothing from it. The basic_monad class template was not motivated and went way over my head. The "Examples of usage" section contained too much obscuring detail and had too many extra things in it like the BOOST_OUTCOME_* macros which were only explained after the code.
This is really useful, thanks.
I think what I might do is to relocate the WG21 speak discussion to
elsewhere and maybe even relocate any mention of expected