Re: runnableExamples should generally be preferred to `.. code-block:: nim`

[dom96]

IIRC .. code-block supports a `filename` (or similar) directive which also 
makes Nim compile the code and run it. For documentation like that it makes 
more sense to use that than `runnableExamples`.