Skip to content

Latest commit

 

History

History
75 lines (52 loc) · 2.67 KB

CONTRIBUTING.md

File metadata and controls

75 lines (52 loc) · 2.67 KB

Contributing

Documentation

Contributions to Prefect Server are always welcome! We welcome your help, whether it's adding new functionality, tweaking documentation, or writing a new tutorial.

Contribution checklist

Commit formatting

When possible, try to craft useful commits. Each commit should be logically distinct and self-contained, which makes reviewing code easier and understanding why changes were made easier.

We recommend following Chris Beam's style guide, which has 7 rules for effective commit messages:

  1. Separate subject from body with a blank line
  2. Limit the subject line to 50 characters
  3. Capitalize the subject line
  4. Do not end the subject line with a period
  5. Use the imperative mood in the subject line
  6. Wrap the body at 72 characters
  7. Use the body to explain what and why vs. how

Changelog

It's important to update Prefect Server's changelog with any adjustments to the project. Each release has a few sections:

  • Features: headline additions to the system
  • Enhancements: improvements to existing functionality, or minor additions
  • Fixes: adjustments that fix bugs or other conditions
  • Deprecations: any deprecated functionality
  • Breaking Changes: any changes that break Prefect Server's backwards-compatibility

To avoid merge conflicts, Prefect tracks changelog entries as separate files in the changes/ directory. To add a new entry:

  1. Create a new file in the changes/ directory. The file name doesn't matter as long as it is unique (we recommend using the issue or PR number e.g. issue1234.yaml or pr1234.yaml).

  2. Choose one (or more if a PR encompasses multiple changes) of the following headers:

    • feature
    • enhancement
    • fix
    • deprecation
    • breaking
  3. Fill in one (or more) bullet points under the heading, describing the change. Markdown syntax may be used. Each entry should consist of a brief description and a link to the relevant GitHub issue(s) or PR(s).

  4. If you would like to be credited as helping with this release, add a contributor section with your name and github username.

Here's an example of a PR that adds an enhancement

enhancement:
  - "Added an awesome new feature to Prefect Server - [#255](https://github.com/PrefectHQ/server/issues/255)"

contributor:
  - "[Zachary Hughes](https://github.com/zdhughes)"

Tests

Make sure that any new functionality is well tested!

Opening a PR

A helpful PR explains WHAT changed and WHY the change is important. Please take time to make your PR descriptions as helpful as possible -- both for code review today and information in the future.