[boost][review] Review of Outcome v2 (Fri-19-Jan to Sun-28-Jan, 2018)

--===============7456711945692894647==
Content-Type: multipart/alternative; boundary="089e082f7d58a481380563142f9d"

--089e082f7d58a481380563142f9d
Content-Type: text/plain; charset="UTF-8"

Hi, Everyone,

The formal review of Niall Douglas' Outcome (v2) library begins Fri-19-Jan
and continues until Sun-28-Jan, 2018.

Your participation is encouraged, as the proposed library is uncoupled and
focused, and reviewers do not need to be domain experts to appreciate the
potential usefulness of the library and to propose improvements.  Everyone
needs (and has suffered) error handling, and can compose an opinion on that
topic.

Outcome is a header-only C++14 library providing expressive and very
lightweight 'outcome<T>' and 'result<T>' error handling, suitable for
low-latency code bases. The library further provides mechanisms for
wrapping '<success|error|exception>' state to safely wrap throwing APIs;
and poses an idiom of, "islands of exception in a sea of noexcept".

Key features:

*- Makes using 'std::error_code' from C++11's <system_error> more
convenient and safe
*- Good focus on low-latency (with tests and benchmarks)
*- Error-handling algorithmic composition with-or-without C++ exceptions
enabled
*- Dependency only on Boost

Recall a previous Outcome (v1) Boost Review occurred 19-May to 02-June 2017:
  *- Outcome (v1) Review Report:
    *- https://lists.boost.org/Archives/boost/2017/06/235783.php

This review for Outcome (v2) includes significant changes as a result of
feedback from the Outcome (v1) review.  For a list of changes (v1==>v2),
see:
  *- https://github.com/ned14/outcome#changes-since-v1

Reference API docs:
  *- https://ned14.github.io/outcome/reference/

GitHub:
  *- https://github.com/ned14/boost-outcome

Tarball:
  *- https://github.com/ned14/boost-outcome/releases/tag/v2.
0-boost-peer-review

Online "play-pen" (try it out!):
  *- https://wandbox.org/permlink/Ji1khzyxoAR0LJQC

YOUR REVIEW
---------------------
Please post your comments and review to the boost mailing list
(preferably), or privately to the Review Manager (to me ;-). Here are some
questions you might want to answer in your review:

- What is your evaluation of the design?

- What is your evaluation of the implementation?

- What is your evaluation of the documentation?

- What is your evaluation of the potential usefulness of the library?

- Did you try to use the library? With what compiler? Did you have any
problems?

- How much effort did you put into your evaluation? A glance? A quick
reading? In-depth study?

- Are you knowledgeable about the problem domain?

And most importantly:

- Do you think the library should be accepted as a Boost library?

For more information about Boost Formal Review Process, see:
http://www.boost.org/community/reviews.html

Thank you very much for your time and efforts.

--charley
Outcome (v2) Review Manager

--089e082f7d58a481380563142f9d
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><span class=3D"gmail-im" style=3D"font-size:12.8px"><span =
style=3D"font-size:12.8px">Hi, Everyone,</span><div style=3D"font-size:12.8=
px"><br></div><div style=3D"font-size:12.8px">The formal review of Niall Do=
uglas&#39; Outcome (v2) library begins Fri-19-Jan and continues until Sun-2=
8-Jan, 2018.</div><div style=3D"font-size:12.8px"><br></div></span><div sty=
le=3D"font-size:12.8px"><span class=3D"gmail-im"><span style=3D"font-size:1=
2.8px">Your participation is encouraged, as the proposed library is uncoupl=
ed and focused, and reviewers do not need to be domain experts to appreciat=
e the potential usefulness of the library and to propose improvements.=C2=
=A0 Everyone needs (and has suffered) error handling, and can compose an op=
inion on that topic.</span><br style=3D"font-size:12.8px"><br style=3D"font=
-size:12.8px"><span style=3D"font-size:12.8px"><span class=3D"gmail-m_33350=
40515125934653gmail-m_-719311828381797212gmail-il">Outcome</span>=C2=A0is a=
 header-only C++14 library providing expressive and very lightweight &#39;o=
utcome&lt;T&gt;&#39; and &#39;result&lt;T&gt;&#39; error handling, suitable=
 for low-latency code bases. The library further provides mechanisms for wr=
apping &#39;&lt;success|error|exception&gt;&#39; state to safely wrap throw=
ing APIs; and poses an idiom of, &quot;islands of exception in a sea of noe=
xcept&quot;.</span><div style=3D"font-size:12.8px"><br></div><div style=3D"=
font-size:12.8px">Key features:</div><div style=3D"font-size:12.8px"><br></=
div><div style=3D"font-size:12.8px">*- Makes using &#39;std::error_code&#39=
; from C++11&#39;s &lt;system_error&gt; more convenient and safe</div><span=
 class=3D"gmail-m_3335040515125934653gmail-m_-719311828381797212gmail-m_-28=
81076472249973944gmail-m_-2717760386870649701gmail-im" style=3D"font-size:1=
2.8px"><div style=3D"font-size:12.8px">*- Good focus on low-latency (with t=
ests and benchmarks)</div></span><div style=3D"font-size:12.8px">*- Error-h=
andling algorithmic composition with-or-without C++ exceptions enabled</div=
></span><span class=3D"gmail-m_3335040515125934653gmail-m_-7193118283817972=
12gmail-m_-2881076472249973944gmail-m_-2717760386870649701gmail-im"><div st=
yle=3D"font-size:12.8px">*- Dependency only on Boost</div><span class=3D"gm=
ail-im"><div style=3D"font-size:12.8px"><br></div><div style=3D"font-size:1=
2.8px">Recall a previous Outcome (v1) Boost Review occurred 19-May to 02-Ju=
ne 2017:</div><div style=3D"font-size:12.8px">=C2=A0 *- Outcome (v1) Review=
 Report:</div><div style=3D"font-size:12.8px">=C2=A0 =C2=A0 *-=C2=A0<a href=
=3D"https://lists.boost.org/Archives/boost/2017/06/235783.php" target=3D"_b=
lank">https://lists.boost.org/Arc<wbr>hives/boost/2017/06/235783.php</a></d=
iv><div style=3D"font-size:12.8px"><br></div><div style=3D"font-size:12.8px=
">This review for Outcome (v2) includes significant changes as a result of =
feedback from the Outcome (v1) review.=C2=A0 For a list of changes (v1=3D=
=3D&gt;v2), see:</div><div><span style=3D"font-size:12.8px">=C2=A0 *-=C2=A0=
<a href=3D"https://github.com/ned14/outcome#changes-since-v1" target=3D"_bl=
ank">https://github.com/ned14/ou<wbr>tcome#changes-since-v1</a></span></div=
><div style=3D"font-size:12.8px"><br></div><div style=3D"font-size:12.8px">=
<span style=3D"font-size:12.8px">Reference API docs:</span><br></div></span=
></span><div style=3D"font-size:12.8px"><div>=C2=A0 *-=C2=A0<a href=3D"http=
s://ned14.github.io/outcome/reference/" target=3D"_blank">https://ned14.git=
hub.io/out<wbr>come/reference/</a></div><span class=3D"gmail-m_333504051512=
5934653gmail-m_-719311828381797212gmail-m_-2881076472249973944gmail-m_-2717=
760386870649701gmail-im"><div><br></div><div style=3D"font-size:12.8px"><sp=
an style=3D"font-size:12.8px">GitHub:</span><br></div></span><div>=C2=A0 *-=
=C2=A0<a href=3D"https://github.com/ned14/boost-outcome" rel=3D"noreferrer"=
 target=3D"_blank" style=3D"font-size:12.8px">https://github.com/ned14/bo<w=
br>ost-outcome</a></div><div><br></div><div><span style=3D"font-size:12.8px=
">Tarball:</span></div><div>=C2=A0 *-=C2=A0<a href=3D"https://github.com/ne=
d14/boost-outcome/releases/tag/v2.0-boost-peer-review" target=3D"_blank">ht=
tps://github.com/ned14/<wbr>boost-outcome/releases/tag/v2.<wbr>0-boost-peer=
-review</a></div><div><br></div><div>Online &quot;play-pen&quot; (try it ou=
t!):</div><div>=C2=A0 *-=C2=A0<a href=3D"https://wandbox.org/permlink/Ji1kh=
zyxoAR0LJQC" rel=3D"noreferrer" target=3D"_blank" style=3D"font-size:12.8px=
">https://wandbox.org/permlink/<wbr>Ji1khzyxoAR0LJQC</a></div><div><br></di=
v><div><div class=3D"gmail-adL" style=3D"font-size:12.8px"><span class=3D"g=
mail-im"><div>YOUR REVIEW</div><div>---------------------</div><div><span s=
tyle=3D"font-size:12.8px">Please post your comments and=C2=A0</span><span c=
lass=3D"gmail-m_3335040515125934653gmail-m_-719311828381797212gmail-il" sty=
le=3D"font-size:12.8px">review</span><span style=3D"font-size:12.8px">=C2=
=A0to the boost mailing list (preferably), or privately to the=C2=A0</span>=
<span class=3D"gmail-m_3335040515125934653gmail-m_-719311828381797212gmail-=
il" style=3D"font-size:12.8px">Review</span><span style=3D"font-size:12.8px=
">=C2=A0Manager (to me ;-). Here are some questions you might want to answe=
r in your=C2=A0</span><span class=3D"gmail-m_3335040515125934653gmail-m_-71=
9311828381797212gmail-il" style=3D"font-size:12.8px">review</span><span sty=
le=3D"font-size:12.8px">:</span><br></div></span></div><div class=3D"gmail-=
adL" style=3D"font-size:12.8px"><div><div style=3D"font-size:12.8px"><div c=
lass=3D"gmail-m_3335040515125934653gmail-m_-719311828381797212gmail-m_-2881=
076472249973944gmail-m_-2717760386870649701gmail-adL"><span class=3D"gmail-=
m_3335040515125934653gmail-m_-719311828381797212gmail-m_-288107647224997394=
4gmail-m_-2717760386870649701gmail-im"><div style=3D"font-size:12.8px"><spa=
n class=3D"gmail-im"><br style=3D"font-size:12.8px"><span style=3D"font-siz=
e:12.8px">- What is your evaluation of the design?</span><br style=3D"font-=
size:12.8px"><br style=3D"font-size:12.8px"><span style=3D"font-size:12.8px=
">- What is your evaluation of the implementation?</span><br style=3D"font-=
size:12.8px"><br style=3D"font-size:12.8px"><span style=3D"font-size:12.8px=
">- What is your evaluation of the documentation?</span><br style=3D"font-s=
ize:12.8px"><br style=3D"font-size:12.8px"><span style=3D"font-size:12.8px"=
>- What is your evaluation of the potential usefulness of the library?</spa=
n><br style=3D"font-size:12.8px"><br style=3D"font-size:12.8px"><span style=
=3D"font-size:12.8px">- Did you try to use the library? With what compiler?=
 Did you have any problems?</span><br style=3D"font-size:12.8px"><br style=
=3D"font-size:12.8px"><span style=3D"font-size:12.8px">- How much effort di=
d you put into your evaluation? A glance? A quick reading? In-depth study?<=
/span><br style=3D"font-size:12.8px"><br style=3D"font-size:12.8px"><span s=
tyle=3D"font-size:12.8px">- Are you knowledgeable about the problem domain?=
</span><br style=3D"font-size:12.8px"><br style=3D"font-size:12.8px"><span =
style=3D"font-size:12.8px">And most importantly:</span><br style=3D"font-si=
ze:12.8px"><br style=3D"font-size:12.8px"><span style=3D"font-size:12.8px">=
- Do you think the library should be accepted as a Boost library?</span><br=
 style=3D"font-size:12.8px"><br style=3D"font-size:12.8px"><span style=3D"f=
ont-size:12.8px">For more information about Boost Formal=C2=A0<span class=
=3D"gmail-m_3335040515125934653gmail-m_-719311828381797212gmail-il">Review<=
/span>=C2=A0Process, see:=C2=A0</span><a href=3D"http://www.boost.org/commu=
nity/reviews.html" rel=3D"noreferrer" target=3D"_blank" style=3D"font-size:=
12.8px">http://www.boost.org/comm<wbr>unity/reviews.html</a><br style=3D"fo=
nt-size:12.8px"><br style=3D"font-size:12.8px"></span><span class=3D"gmail-=
im"><span style=3D"font-size:12.8px">Thank you very much for your time and =
efforts.</span></span></div><span class=3D"gmail-im"><div style=3D"font-siz=
e:12.8px"><span style=3D"font-size:12.8px"><br></span></div><div style=3D"f=
ont-size:12.8px"><span style=3D"font-size:12.8px">--charley</span></div><di=
v style=3D"font-size:12.8px"><span style=3D"font-size:12.8px">Outcome (v2) =
Review Manager</span></div></span></span></div></div></div></div></div></di=
v></div></div>

--089e082f7d58a481380563142f9d--

--===============7456711945692894647==
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: inline