Better documentation for our examples

Just playing around how this renders on github ;)
2 files changed