Add documentation on discovery
Syntax highlight JSON examples
Note that we use pluralised forms of nouns in routes
Merge pull request #176 from WP-API/getting-started-docs-update

Update getting started documentation.  Closes #176.