include code examples in API docs
added some more doc examples (still going, #8!)