Clarified the README documentation.
Some further refinements to the README.md.
Merge branch 'readme' of https://github.com/polyglot-jones/swagger into polyglot-jones-readme

Conflicts:
	README.md
Merge branch 'polyglot-jones-readme'