isn't the whole point of rst though that it's sufficiently structured to extract detailed code blocks to pass to the compiler? ie if you're not using this feature of rst, it's completely useless compared to markdown which has a much larger developer mindshare.
tbh, I found the runnableExamples distracting to look at - they're syntax colored along with the rest of the actual code and it's hard to know when the example ends and real code begins (indent is not that clear) - they muddle the logic It also looked hard to surround examples with descriptive text - you have to start a comment block, end it, write a runnableexample, then start a new comment block which seems really ugly..
