Severe content and markup modifications

Aside from fixing up the source for GitHub's parsing, I added commentary to match some of my script and clarified things so the document would stand reasonably well on its own.