Re: [boost] [outcome] success-or-failure objects

Subject: Re: [boost] [outcome] success-or-failure objects
From: Niall Douglas (s_sourceforge_at_[hidden])
Date: 2018-01-23 14:44:05

On 23/01/2018 13:52, Vinícius dos Santos Oliveira via Boost wrote:
> I'm liking what I saw so far. Just a small comment on the documentation.
> I'm curious what the following sentence does even mean? Is it supposed to
> confuse the user or something? It's a sign of bad taste really.
> 
>> Outcome’s default is to not provide value-or-error objects. It provides
> success-or-failure objects.
> 
> What does that even mean? value-or-error... well, if it is non-error, I
> assume it is success. Both sentences mean just the same. As do their API
> (encapsulate either A or B). The rest of the paragraph is okay. If you just
> remove this comment, confusion will go away. No other changes need to be
> done in this paragraph. Just remove this misleading means-nothing comment.

Literally, straight after what you quoted it says:

"Outcome’s default is to not provide value-or-error objects. It provides
success-or-failure objects. We define the difference as being “having
programmable actions in response to no-value observation other than
throwing a hard coded logic error type exception”."

Can you explain why this is confusing to you?

Niall

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