Changelog & Labels - powerhome/playbook GitHub Wiki

This project uses the github-changelog-generator. We automatically generate our changelog each release based off the title of the PR + the labels used.

We use the following labels to generate the section headings within the changelog: enhancement, bug, improvement, new kit, deprecated, & breaking. Do not use more than one of the following labels on a PR.

Enhancement

This is used when your PR contains new features, new props, or new design variants. These are backward compatible. Typescript conversions also fall under this category.

Bug

Fixes to issues and bugs discovered in Playbook.

Improvements

This is used when your PR contains library upgrades or doc/site improvements. Generally will not affect the kit in any way. These are backward compatible.

New Kit

Use this when adding a new kit to Playbook

Deprecated

Use this label when you have removed or plan to remove kits or props. These are usually NOT backward compatible.

Breaking

This label indicates that a breaking change was introduced. Use this when your update is NOT backward compatible. Any deletion or rename of a prop is a breaking change unless it’s made backward compatible. Changes to prop types are also breaking. Changes to enum values can also be breaking depending on the use cases. Another clue for breaking changes are updates to tests. If a PR includes a breaking change we need to treat it with considerable scrutiny. If you are unsure if your PR is a breaking change or not, please reach out to the Playbook team for feedback.