[boost] Fwd: [outcome] Tutorial third rewrite finished (I hope)

Subject: [boost] Fwd: [outcome] Tutorial third rewrite finished (I hope)
From: Niall Douglas (s_sourceforge_at_[hidden])
Date: 2017-03-05 10:39:24

Looks like boost-dev wasn't working yesterday, so resending this.

-------- Forwarded Message --------
Subject: [outcome] Tutorial third rewrite finished (I hope)
Date: Sat, 4 Mar 2017 09:28:51 +0000
From: Niall Douglas <s_sourceforge_at_[hidden]>
To: boost_at_[hidden]

I know the Safe Numerics review is currently happening and almost
straight thereafter comes the final Stacktrace review so people are
probably a bit tired of reviewing stuff, however I believe the third
rewrite of the Outcome tutorial is now finished at long last.

Expected<T, E> in Context:
https://ned14.github.io/boost.outcome/md_doc_md_02-tutorial_a.html

Expected<T, E> in Practice:
https://ned14.github.io/boost.outcome/md_doc_md_03-tutorial_b.html

Refining Expected<T, E>:
https://ned14.github.io/boost.outcome/md_doc_md_04-tutorial_c.html

Feedback is once again very welcome, indeed this tutorial looks so very
different from the previous two editions because of your feedback, so
thank you.

In case anyone is interested, the biggest showstopper remaining before
this goes into the Boost review queue is the reference docs: doxygen
chokes badly on the preprocessor metaprogramming Outcome uses and
generate rubbish docs. I didn't find much success with Standardese or
Doxypress either, so I'm currently working with my shiny new Python C99
conforming preprocessor (https://github.com/ned14/pcpp) to partially
preprocess Outcome into a form doxygen can cope with. I expect a few
weeks remain on that, it may pass most of the C11 preprocessor torture
test suite but the partial preprocessor pass through implementation has
bugs I'm still nailing down :)

Niall

-- 
ned Productions Limited Consulting
http://www.nedproductions.biz/ http://ie.linkedin.com/in/nialldouglas/