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
Merge pull request #955 from kbarber/maint/stable/fix-environment-endpoint-links

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