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.
