DOC: typos and other corrections

Thanks @antgonza