Here's looking at you, kid

[Gerald Jansen via Digitalmars-d]

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