[outcome] Tutorial third rewrite finished (I hope)
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/
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@nedprod.com> To: boost@lists.boost.org 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/
participants (1)
-
Niall Douglas