I started playing with editable and runnable examples: https://github.com/perifer/documentation/tree/run
It only makes sense to enable this in a MacGap context and I saw that there were talks about an example app. So one idea is to point this example app to the documentation.