Bug Submission Guide¶

Issues, feature requests, and bug reports should be reported using the issue tracking system.

If you are reporting a bug with puppet, please make sure to include relevant configuration files, log messages, environment variables, Ruby version, operating system, and the captured output of the —trace, —debug, and —verbose options.

Submission Guide¶

In order to address the issue as quickly as possible, please use the following format when submitting your bug. This is not required, but it will help Puppet Labs and the community quickly process the information.

Summary:

Steps to Reproduce:

Expected Results:

Actual Results:

Regression:

Notes:

Email Submission¶

You can now send an email to tickets@puppetlabs.com to create a ticket. You must have a Redmine account to do this and your From address must match the address on your Redmine account. Any attachments added to the email will be applied to the ticket.

By default, issues are added to the Puppet project but you can override this by specifying the Project option in the email body:

Project: facter

(Or dashboard, module-site (Forge), puppet-docs)

Redmine tries to use the plain text part of the email to fill the description of the issue. If a HTML-only email is received, HTML tags are removed from its body.

You can also reply to a Redmine ticket notification email and the relevant ticket will be updated.

You can find more information about Redmine receiving emails here.