On Wednesday, 9 October 2013 at 07:04:07 UTC, Kagamin wrote:
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.

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.

Reply via email to