Fixes a typo and revises a few sentences for grammar.
Also add more troubleshooting and sample output.
/cc: @rdavila, @godfat, @lbot