Human unreadable documentation - the ugly seam between simple D and complex D

[Panke via Digitalmars-d]

On Thursday, 26 March 2015 at 21:36:56 UTC, rumbu wrote:
> On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote:
>> On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote:
>>> ...snip...
>>
>> So tl;dr; make the template constraints in ddoc less prominent?
>>
>> The "new library reference preview" under Resources seems to 
>> already have this (example: 
>> http://dlang.org/library/std/algorithm/searching/starts_with.html)
>
> This will not solve the readability problem:
>
> - what is a range?
> - what is a needle?
> - what is a predicate?
>
> Phobos is reinventing the OOP encapsulation without providing 
> the minimal tools. IMHO, something similar to "interface" is 
> mandatory to define constraints for "range" and the 
> relationship between "needle" and "range".

Never heard that complain about python's protocols which have no
language support whatsoever.