On Friday, 13 November 2015 at 22:34:18 UTC, Andrei Alexandrescu
wrote:
Amid increased scrutiny it's important to focus on improving
documentation. ...
The example code snippets on the home page are great. They
certainly impressed me favourably back this spring when I first
got curious about D. It would be great if there were even more
examples. (Could the curl example fetching weather info be
revived?)
Of course it's disastrous if a newcomer has a look at an example,
hits the "Run" button and gets back a vomit of incomprehensible
error messages. The "Round floating point numbers" example is
still in this camp and needs to be fixed (by someone who
understands regular expressions better than me) [1].
Much work has been done in the past months to improve the
infrastructure used to run the examples, but even more could be
done. It would be great if there was an automated/continuous
checking mechanism to make sure all the examples run correctly.
Maybe there could be some background functions (not displayed,
for brevity) doing some input checking in order to handle the
most common exceptions (eg. empty input).
[1] https://issues.dlang.org/show_bug.cgi?id=12210#c12
