Docs: typos, wording, rewriting, add a Makefile
Merge pull request #1464 from magopian/more-docs-improvements

various small docs improvements, typos, fixes, add a Makefile