puppet-strings1

Usage

Overview

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.

Actions

generate
Generate documentation from files.

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

Options

--format FORMAT  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

Formats

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

Examples

If you want to generate a single reference file, use something like:

You can otherwise generate HTML documentation this way:

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>