Update documentation examples to actually, you know, run

[gadomski]

We use await in the examples which means you can't just execute them. This probably will require some reading around to figure out the best way to have async code examples in docs.