Minor specification revisions

Tidied up introductory text for a few paragraphs, minor formatting changes to call out field names, relabelled sections to use a consistent structure (Required, Recommended, Optional)
Merge pull request #3 from ldodds/master

Minor specification revisions