logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

puppet-strings - Generate Puppet documentation with YARD

Actions

generate
         Generate documentation from files.

       server
         Runs a local documentation server for the modules in the current Puppet
         environment.

Additional Documentation

       See the upstream documentation at:
        <https://puppet.com/docs/puppet/latest/puppet_strings.html>

       Code examples and style guide can be found at:
        <https://puppet.com/docs/puppet/latest/puppet_strings_style.html>

Author

       Louis-Philippe Véronneau

                                                      2024                                     PUPPET-STRINGS(1)

Bugs

       Bugs    can    be    reported    to    your    distribution's    bug    tracker    or     upstream     at
       <https://github.com/puppetlabs/puppet-strings/issues> .

Description

       Produce complete, user-friendly module documentation by using Puppet Strings.  Strings uses tags and code
       comments,  along  with  the source code, to generate documentation for a module's classes, defined types,
       functions, tasks, plans, and resource types and providers.

       Puppet Strings is based on the YARD Ruby documentation tool.

Examples

       If you want to generate a single reference file, use something like:
          $ puppet strings generate --format markdown --out REFERENCE.md

       You can otherwise generate HTML documentation this way:
          $ puppet strings generate

Formats

       Possible formats are: "markdown", "textile", "rdoc", "ruby", "text", "html", or "none".

Name

       puppet-strings - Generate Puppet documentation with YARD

Options

--formatFORMAT  The rendering format to use (see FORMATS below)
       --out            The output file when using the markdown or json formats
       --verbose        Whether to log verbosely
       --debug          Whether to log debug information
       --help           Show the help screen

Synopsis

       puppet strings <action>
       puppet strings --help

See Also