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

[Israel 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?

Wouldnt that just be "Further documentation" for advanced 
programming concepts?
Only simple easy to understand examples are needed to begin with.

It should flow like a tree.