A little update to the wording and formatting of the docs.

The content is great, but the readability was a little hard. This commit attempts to keep the spirit and tone of the original text but improve the understandability.
Merge pull request #1 from jhubert/scripting_docs_spellcheck

A little update to the wording and formatting of the docs.