Fix environment end-point links to be compatible with our docs site

The links in the environments end-point weren't compatible with the
markdown that our docs site uses. This patch fixes the links to be
compatible.

Signed-off-by: Ken Barber <ken@bob.sh>
Wrap API examples in back-ticks to make the hyperlinks work
Fix example query to be JSON, not clojure
Correct hyperlink to anchor syntax in FAQ
Updated the release notes for the 2.0.0 release
Merge pull request #956 from senior/maint/stable/2.0.0-release-notes

Updated the release notes for the 2.0.0 release
Merge pull request #955 from kbarber/maint/stable/fix-environment-endpoint-links

Fix environment end-point links to be compatible with our docs site
(PDB-626) Added some additional fixes/features to the 2.0.0 release notes
Merge pull request #957 from senior/main/master/release-note-fixes

(PDB-626) Added some additional fixes/features to the 2.0.0 release notes
DOCS: We now need Puppet 3.5.1, not 3.4.2
Another case of Puppet 3.4.2
Other cases of facter/puppet requirements that were not changed
Merge pull request #958 from kbarber/maint/stable/fix-puppet-requirement-on-index

DOCS: We now need Puppet 3.5.1, not 3.4.2
Merge branch 'stable'

* stable:
  Other cases of facter/puppet requirements that were not changed
  Another case of Puppet 3.4.2
  DOCS: We now need Puppet 3.5.1, not 3.4.2
  (PDB-626) Added some additional fixes/features to the 2.0.0 release notes
  Updated the release notes for the 2.0.0 release
  Correct hyperlink to anchor syntax in FAQ
  Fix example query to be JSON, not clojure
  Wrap API examples in back-ticks to make the hyperlinks work
  Fix environment end-point links to be compatible with our docs site