Skip to content

Latest commit

 

History

History
51 lines (29 loc) · 2.64 KB

CONTRIBUTING.md

File metadata and controls

51 lines (29 loc) · 2.64 KB
Raw

Contributing to FFWD

Thanks for taking the time to contribute!

The following is a set of guidelines for contributing to FFWD.

Ground Rules

  • Please open an issue for discussion before submitting any major changes.
  • Be sure to add a comment to your PR explaining the reason for the change. Please include some context behind a bug or issue you ran in to, or your use case and why you need a particular feature added. If you're unsure about formatting, you can follow this article which dives into writing a proper commit message.
  • Include tests for any large changes. Read here to learn how to run the tests.
  • Include new or updated documentation in the related PR.

Your First Contribution

Unsure where to begin contributing to FFWD? You can start by browsing through these starter issues.

Working on your first Pull Request? You can learn how from this free series, How to Contribute to an Open Source Project on GitHub.

Getting started

We use GitHub to manage issues. You can follow along and create issues here.

Create your own fork of the code

Commit message conventions

  • If possible, limit your changes to one module per commit. If you add new, or modify existing classes. Keep that change to a single commit while maintaining backwards compatible behaviour.

  • The first line of the commit should be formatted with [module1,module2] my message.

Testing

  • Before setting up a pull request, run the comprehensive test suite as specified in Testing.
  • PRs with failing tests will not be merged.

How to report a bug

Please open an issue under the bug label and we will prioritize it based on the severity.

How to suggest a feature or enhancement

If you find yourself wishing for a feature that doesn't exist in FFWD, you are probably not alone. Open an issue on our issues list on GitHub which describes the feature you would like to see, why you need it, and how it should work.

Code of Conduct

This project adheres to the Open Code of Conduct. By participating, you are expected to honor this code.