Updated the release notes for PDB-675
(PDB-47) Enable structured facts from facts terminus

This patch disables the stringify that we perform on outbound facts before
they are sent to the PuppetDB service.

To keep backwards compatibility, for now we are flattening these facts out
to strings before they are stored.

Signed-off-by: Ken Barber <ken@bob.sh>
Include documentation for 'store report' version 4

This adds documentation around the store report command version 4 that includes
the new status field. The old version of the command and wire format have been
marked as deprecated.

Signed-off-by: Ken Barber <ken@bob.sh>
Correct link to Puppet report format documentation

Signed-off-by: Ken Barber <ken@bob.sh>
Fix type in overall

Signed-off-by: Ken Barber <ken@bob.sh>
Updated the release notes for PDB-675
Merge pull request #1006 from kbarber/maint/stable/missing_v4_report_wire_format

Include documentation for 'store report' version 4 (and other minor doc fixes)
Merge pull request #1005 from kbarber/ticket/master/pdb-49-unflatten-facts-from-terminus

(PDB-47) Enable structured facts from facts terminus
Fix example for nodes endpoint to show 'certname' in response

Signed-off-by: Ken Barber <ken@bob.sh>
Merge pull request #1007 from kbarber/maint/stable/fix-nodes-response-example

Fix example for nodes endpoint to show 'certname' in response
Merge branch 'stable'

* stable:
  Fix example for nodes endpoint to show 'certname' in response
  Updated the release notes for PDB-675
  Fix type in overall
  Correct link to Puppet report format documentation
  Include documentation for 'store report' version 4
(docs) Revise API docs for updated info, clarity, consistency, and formatting

This revision touches most of the pages in the v3 and v4 API docs, as well as
the release notes. We've:

* Standardized some squirmy terminology
* Adjusted the flow of several pages
* Caught two or three spots where the docs lagged behind the implementation
* Made the Markdown syntax a little more portable (summary: Let's not use the
  "\n: " definition list syntax anymore. Multi-graf list items and nested lists
  get indented four spaces, not two or three.)
* Added context about how certain objects work and how they relate to other objects
* Added info about how query operators interact with field data types
Merge pull request #1011 from nfagerlund/jul_2014_docs_revisions_for_stable

(docs) Revise API docs for updated info, clarity, consistency, and formatting
Merge branch 'stable'

* stable:
  (docs) Revise API docs for updated info, clarity, consistency, and formatting
(PDB-488) Add producer timestamps to factsets and catalogs.

This pull request adds a `producer-timestamp` field to the top level of
of the facts and catalog structures passed from the master to PuppetDB, along
with an accompanying database migration and index. Ultimately this field
or something inserted in its place will be populated by agent nodes and used
for an agent-relative record of time compatible with possibly divergent
master clocks in a multiple-master setup.
(docs) Fix glitches noticed while backporting recent revisions to 1.6.x

* In 2.1 and up, the events endpoint is unsorted for v3 and v4.
* v3 doesn't support environments, but one line about them snuck in.
* Accidentally let "certname" (a v4-ism) slip into v3/nodes.
* Fix a busted URL and some glitchy header levels.
(docs) Port recent docs revisions to 1.6.x branch

This commit brings over the relevant changes from commit eb20757, since PuppetDB
1.6 will stay around a while for PE customers. I applied them by hand rather
than cherry-picking, to ensure no 2.1-isms would sneak over.
Add deprecation warnings
Merge pull request #1008 from wkalt/ticket/master/pdb-488-producer-timestamp

(PDB-488) Add producer timestamps to factsets and catalogs.
Merge pull request #1012 from nfagerlund/jul_2014_docs_16x

(docs) Port recent docs revisions to 1.6.x branch