Improve examples and options doc, fix passive voice