api: adding missing examples, and editing reference docs
api & guide: cleaning up images