We need better documentation for functions with ranges and templates

[tcak via Digitalmars-d]

On Wednesday, 16 December 2015 at 18:25:31 UTC, Luís Marques 
wrote:
> On Monday, 14 December 2015 at 19:04:46 UTC, bachmeier wrote:
>> Something has to be done with the documentation for Phobos 
>> functions that involve ranges and templates.
>
> Just today:
>
> - "Where's the documentation for makeIndex?"
>
> - http://imgur.com/4SQckvN
>
> - "AHHHHHH!" *runs away*

It is all about how the details of function declaration is shown. 
If you look at the function's template parameters, function 
parameters, and conditionals separately, I do not think it is any 
complex at all.