The major change here was the user guide section; it was completely rewritten. I tried to:
I'm working these issues #22 (closed), #21 (closed) and #20 (closed) with this PR.