Fixed some english & docs

I'm not a native either, but I tried to fix some english. I also added some docs.

:warning: make sure you read/check all context of this PR before merging, I'm not sure about everything.