Add a reference task to generate REFERENCE.md

[ekohl]

In puppet-extlib we can now set:

Rakefile:
  puppet_strings_patterns: lib/puppet/functions/extlib/*.rb

[ekohl]

I left it out here, but I think we can now modify our Travis release job as follows:

before_deploy: "bundle exec rake reference"

That should fix part of #397 by ensuring we always have an up to date REFERENCE.md on the forge for released modules.

[ekohl]

Btw, puppetlabs/puppet-strings#192 is similar, but doesn't allow overriding the pattern via the config.

[ghoneycutt]

This should document what the fields are or link to the documentation as this is hard to grok.

[ekohl]

You're right. I initially attempted to pass in arguments as a named hash but it looks like the rake invoke task doesn't support this so I took this short cut.

[ekohl]

Updated. This now requires the freshly released puppet-strings 2.2.0 which includes my patch with a strings:generate:reference. That makes our invocation a lot easier and self documenting.

[ekohl]

voxpupuli/puppet-extlib#131 is how puppet-extlib would make use of this.

[logicminds]

This should be

Rakefile:
  puppet_strings_patterns: lib/puppet/functions/**/*.rb functions/**/*.pp

[ekohl]

Not sure I follow. Why is that?

[logicminds]

Ahh nevermind that is the custom config for the extlib.