additional explanation and tiny bit of markdown to show angle brackets
Merge pull request #1 from alphagov/doc_updates

update to the high level documentation