Docs: typos, wording, rewriting, add a Makefile (bug 880698)