Editing the repo, in particular the markdown files 

Hello, 

I would like to point out to you that there are many spelling errors in the markdown documents. Also, I feel some code could be added or changed for completion.

Can I start working on it and send a pull request?