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

[arnetheduck]

regarding editors, the same applies - an editor could easily provide ide 
features in code block sections thanks to RST