Worst Phobos documentation evar!

[Walter Bright via Digitalmars-d]

On 12/30/2014 7:20 AM, Adam D. Ruppe wrote:
> std.algorithm could mention the concept of laziness, show examples of the opaque
> functions, have examples of the common (like seriously one of the most
> frequently asked questions I've seen) "how do I turn it into an array?", or
> show/explain how and why to avoid that.


Yes, better examples of solving real world issues would be better, and is 
exactly why I did these two documentation examples:

   https://github.com/D-Programming-Language/phobos/pull/2805
   https://github.com/D-Programming-Language/phobos/pull/2806

If you've got ideas for better examples for other functions, please, don't hold 
back!