(#22356) Add api documentation for reports

This adds a draft of documentation for the reports "REST" api.

This version is a DRAFT with lots of questions.
(#22356) Add json schemas for the report objects
(#22356) add spec test and vanilla (useless) schema
(#22356) Add json schemas for the event object
(#22356) Add report API json-schema, validation, and documentation.

This adds documentation and a complete json-schema (draft 4) for the
report API endpoint. The documentation includes an example.

A report test validates the schema itself as well as a generated report
to ensure that the schema describes what is generated.
(#22356) Change POST to PUT, fix Ruby 1.8.7 and windows issue

1.8.7 does not have File.absolute_path which broke the test. Method not
needed since jsonschema for report is no "all in one file".

The schema gem does not work on windows; tests cannot run there.

HTTP PUT is the method used for the report API, not POST.
(#22356) Remove deprecated yaml from the description

This also updates the link to where the documentation is (will be).
Merge pull request #1884 from hlindberg/feature-22356-report-api-doc

(#22356) Add api documentation for reports