runnableExample considered harmful / good feature to deprecate before 1.0?

[exelotl]

Personally I think runnableExamples make Nim harder to learn for newcomers.

When viewing docs I would much rather read:

> **Example:**
>     
>     
>      echo some(42).get      # prints 42
>     echo none(string).get  # error! raises UnpackDefect
>     
>     Run

instead of:

> **Example:**
>     
>     
>      assert some(42).get == 42
>     doAssertRaises(UnpackDefect):
>       echo none(string).get
>     
>     Run