Add task to generate report reference

    bundle exec rake references:report

It runs `puppet doc -r report` to generate references/report.md

The docs site does not use the generated markdown to render the webpage, but at
least this file will be accurate if new report processors are added in the future.

rakelib/generate_references.rake

@@ -5,6 +5,8 @@ CONFIGURATION_ERB = File.join(__dir__, 'references/configuration.erb')
 CONFIGURATION_MD  = File.join(OUTPUT_DIR, 'configuration.md')
 METAPARAMETER_ERB = File.join(__dir__, 'references/metaparameter.erb')
 METAPARAMETER_MD  = File.join(OUTPUT_DIR, 'metaparameter.md')
+REPORT_ERB        = File.join(__dir__, 'references/report.erb')
+REPORT_MD         = File.join(OUTPUT_DIR, 'report.md')
 
 def render_erb(erb_file, variables)
   # Create a binding so only the variables we specify will be visible
@@ -48,4 +50,10 @@ namespace :references do
     body = puppet_doc('metaparameter')
     generate_reference('metaparameter', METAPARAMETER_ERB, body, METAPARAMETER_MD)
   end
+
+  desc "Generate report reference"
+  task :report do
+    body = puppet_doc('report')
+    generate_reference('report', REPORT_ERB, body, REPORT_MD)
+  end
 end

rakelib/references/report.erb

@@ -0,0 +1,13 @@
+---
+layout: default
+built_from_commit: <%= sha %>
+title: Report Reference
+toc: columns
+canonical: "/puppet/latest/report.html"
+---
+
+# Report Reference
+
+> **NOTE:** This page was generated from the Puppet source code on <%= now %>
+
+<%= body %>