Example within documentations of D seriously need some improvement.

[Alexander Battisti]

Just starting myself with D, I can second that.  This (
http://warpspire.com/talks/documentation/ ) explains much better than
I could, how important documentation is.

> The best type of tutorial and documentation format I have seen so far
> and yet simple to understand are shown here.
>
> http://www.w3schools.com/php/php_operators.asp

Have you seen CoffeeScript's documentation?
http://jashkenas.github.com/coffee-script/

Alexander Battisti

p.s. Having some extra time in the next few months, I would be glad to
help with improving the state of the documentation.