mismatch and return value

[ketmar via Digitalmars-d-learn]

On Wednesday, 13 July 2016 at 11:13:00 UTC, Mike Parker wrote:
> To be fair, I think it's only obvious to someone who has 
> achieved a certain level of comfort and familiarity with ranges 
> and the range-based functions in Phobos. This particular 
> function could just as easily be inferred to return an empty 
> tuple rather than a tuple of two empty ranges. Being more 
> specific about the return value is only a few extra words that 
> I wouldn't judge as being "too wordy".

probably you are right. it is somewhat hard to judge when you 
know the concept "by your heart". also, i always thought about 
phobos docs as "reference", not something people should learn 
from. i.e. "i already know how it works, and i just need to look 
for non-obvious details".

it will be great to have "two-level documentation", with 
reference level and in-depth explanation level, but i understand 
how much efforts it will require...