DOC: notes about examples and minor edits