Pragmatic D Tutorial

[qznc]

On Wednesday, 9 October 2013 at 07:04:07 UTC, Kagamin wrote:
> http://beza1e1.tuxen.de/d-tut-0.1/documentation.html
> Are doxygen comments still endorsed?

I am not aware about any counter arguments. Are there some 
downsides? I noticed that "Returns:" is rarely used in Phobos.

> http://beza1e1.tuxen.de/d-tut-0.1/idiomatic.html
> Describing a range as a pair of iterators requires a reader 
> with C++ background; the beginning of the tutorial implied 
> wider audience. For other people it can be not informative or 
> misleading.

Good point.