> True, but this is a shortcoming of the highlighter. Everything is always a "tooling" problem. Can't see if the variable is a `let` or a `var` in Python? Make the highlighter detect it, assign-once variables should be green, multiple assignment variables should be blue... Point is, highlighting is complexity tradeoff too and a there is no need to detect and extract code blocks within comments when they are outside of comments.
> Breaking separation of concerns by putting pure doc sample code outside of > doc comments which makes it look like regular code is the wrong answer. Ah we play the noun game now. Runnable examples are code and should be written as code, don't separate identical concerns. > Searching for runnableExamples in Nim's github project even finds some code > where it is used outside of any doc comment context, which means it is > silently ignored. That's just not true.
