Re: runnableExample considered harmful / good feature to deprecate before 1.0?

[Araq]

Doc comments themselves are annoying in the source code but outsourcing them to 
different files is not a good way of doing things either. What's currently been 
missed in this discussion here IMO is that `runnableExamples` are not just 
documentation, they are also tests and I've yet to see somebody arguing for 
"Put tests in comments so that they are easier to ignore".