add metadata to markdown

tasks/docs.rb

@@ -50,6 +50,11 @@ def p(msg)
     def suffix
       '.md'
     end
+
+    def meta(opts)
+      o = opts.map { |k, v| "#{k}: #{v}" }.join("\n")
+      "---\n#{o}\n---\n\n"
+    end
   end
 end
 
@@ -91,16 +96,21 @@ def p(msg)
     def suffix
       '.rst'
     end
+
+    def meta(o)
+      '' # ignore for now
+    end
   end
 end
 
 namespace :docs do
   desc 'Create cli docs'
   task :cli do
     f = RST
-    res = f.h1('InSpec CLI') +
-          f.p('Use the InSpec CLI to run tests and audits against targets '\
-              'using local, SSH, WinRM, or Docker connections.')
+    res = f.meta(title: 'About the InSpec CLI')
+    res << f.h1('InSpec CLI') +
+           f.p('Use the InSpec CLI to run tests and audits against targets '\
+               'using local, SSH, WinRM, or Docker connections.')
 
     require 'inspec/cli'
     cmds = Inspec::InspecCLI.all_commands