5 Contributing

Patches, bug reports, and other feedback are welcome. Please send a plain-text email to piem@inbox.kyleam.com. Messages that include this address are public and available as public-inbox archives at https://inbox.kyleam.com/piem. Note that this is not a mailing list. Updates can be followed through one of public-inbox’s pull methods (see public-inbox). This means it is particularly important to not drop participants when replying.

You can, unsurprisingly, use piem to work on piem by adding an entry like this to piem-inboxes.

("piem"
 :coderepo "<path/to/local/clone>"
 :address "piem@inbox.kyleam.com"
 :url "https://inbox.kyleam.com/piem/")

The source repository is available at https://git.kyleam.com/piem. Here are some guidelines for sending patches:

• Please send patches inline rather than as attachments.

  If you’re using git send-email, you may want to set sendemail.to to piem@inbox.kyleam.com in your local repository.

• Specify the base commit.

  This can be done via the --base= option of git format-patch or by configuring format.useAutoBase.

• Keep rerolls in the same thread.

  In general, prefer to keep iterations of a patch series in the same thread, labeling rerolls with an appropriate version.

• Consider adding a range-diff to the cover letter of rerolls.

  For a multi-patch series, git range-diff can often provide a nice overview of the changes between the previous and last iteration. Note that git format-patch has a --range-diff convenience option.