Updated the user guide.

Better documentation of job polling, plus some typos corrected, and clearer syntax highlight colours.

@matthewrmshin - please review.