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