In a couple of issues (see #16 for example) we've started to develop a basic format for examples that help us understand and explain different aspects of how the API might work. We should build that out and include some of those to help highlight how the API works.