I'm using the following versions of yard and puppet strings:
$ puppet resource package yard provider=puppet_gem
package { 'yard':
ensure => ['0.9.12'],
}
$ puppet resource package puppet-strings provider=puppet_gem
package { 'puppet-strings':
ensure => ['1.1.1'],
}
Using the syntax documented in de the README I get the following error:
$ puppet strings generate --format markdown
Error: Could not parse application options: invalid option: --format
So I checked the options (puppet strings generate --help
) and it seems --format
has been replaced with --render-as
. But when I try to render the documentation I get an error that it does not support markdown.
$ puppet strings generate --render-as markdown
Error: Could not parse application options: I don't know how to render 'markdown'
So is markdown output no longer supported or am I doing something wrong?
bundle exec puppet strings generate --format markdown ./lib/puppet/**/*.rb
worked for me.