Please upgrade user guide

documentation: User guide.

The content really needs to be (re)written by an editor with solid English skills, highly suggest someone with English as their 1st language. The user guide 1st page summary paragraphs are so broken the intended message is lost or indecipherable.

can you give some specific examples?

Also we gratefully receive pull requests for documentation as well as code!