I think we just need a consistent guidelines on that.
Maybe separating those runnable examples cleanly in all codebases would help:
fun foo() =
## Foo does foo
# #### Example #####
runnableExamples:
foo()
# #### Example #####
echo "Foo"
Run
