Clean up + add code examples

[lukefretwell]

• The code blocks aren't consistent, so would be great to clean those up.
• Add code examples where appropriate