DOC: minor typos + as usual "imperative" style