(PDB-605) Pin facter requirement to 1.7.0

Puppet 3.5.1 pins to Facter 1.7.0, and whats more 1.6.x is no longer
maintained so this patch just corrects that.

Signed-off-by: Ken Barber <ken@bob.sh>
Merge pull request #954 from kbarber/maint/stable/pin-to-facter-170

(PDB-605) Pin facter requirement to 1.7.0
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
Fix a race condition in the import/export round-trip clojure tests

This scenario occurred if command processing for facts is slow. A result
with the hard coded certname would be returned with no fact values or
environment. This commit fixes the code to only return results when
facts are found.
Merge pull request #961 from senior/maint/stable/import-export-test-race-condition-fix

Fix a race condition in the import/export round-trip clojure tests
Update release notes with more upgrade warnings

I've nabbed the upgrade warnings from the announcement and put them here to
make sure our notices aren't missed. It seems not everyone reads the
announcement and we really should have the warnings here anyway for
permanence.

Signed-off-by: Ken Barber <ken@bob.sh>
Merge pull request #963 from kbarber/maint/stable/expand_release_notes

Update release notes with more upgrade warnings
Fix reference to PuppetDB 1.6.x in index.markdown

Signed-off-by: Ken Barber <ken@bob.sh>