> Proper comment and proper output. > writeln(1+2); // should print 3, numbers are added.
There's nothing proper about that. I've already fixed a bunch of examples in the documentation because they had comments explaining the results instead of using an assert. And the comments were wrong, because it turns out that some part of the compiler has changed which makes the output of some call to writeln() different. You can only catch such cases if they're in an assert. Every new D programmer should learn about assert. Once they've seen a couple of examples there will be nothing ambiguous about seeing it in the documentation again. And you can't treat readers as if they're going to be newbies forever.