Skip to content

Latest commit

 

History

History
47 lines (31 loc) · 2.83 KB

CONTRIBUTING.md

File metadata and controls

47 lines (31 loc) · 2.83 KB
Raw

Introduction

Thank you for considering contributing to Wafer.

Wafer is an open source project and we love to receive contributions from our community — you! There are many ways to contribute, from improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into Wafer itself. As Wafer is still pre 0.1, there are no channels other than the issue tracker setup for communication. If you have a support question, please file an issue with the tracker. This may change as Wafer grows.

Responsibilities

  • Create issues for any major changes and enhancements that you wish to make. Discuss things transparently and get community feedback.
  • Keep feature versions as small as possible, preferably one new feature per version.
  • Be welcoming to newcomers and encourage diverse new contributors from all backgrounds. See our Code of Conduct and the Rust Community Code of Conduct.

Your First Contribution

Unsure where to begin contributing to Wafer? You can start by looking through the tracker and assign yourself to any issue that currently do not have an assignee. Issues labeled Help wanted in particular.

Working on your first Pull Request? You can learn how from this free series, How to Contribute to an Open Source Project on GitHub. If a maintainer asks you to "rebase" your PR, they're saying that a lot of code has changed, and that you need to update your branch so it's easier to merge.

How to report a bug

If you find a security vulnerability, do NOT open an issue. Email [email protected] instead.

When filing an issue, make sure to answer/consider these five questions:

  1. Have you updated to the latest rust nightly?
  2. What operating system and processor architecture are you using?
  3. What did you do?
  4. What did you expect to see?
  5. What did you see instead?

How to suggest a feature or enhancement

Wafer aims to be fast and easy to operate. The feature list for v0.1 has already been roadmapped and will not change before that time. With that being said, if you find yourself wishing for a feature that doesn't exist in Wafer, you are probably not alone. There are bound to be others out there with similar needs. Many of the features that Wafer has today have been added because our users saw the need. 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. The community will decide on its adoption and how to best implement it.

Code review process

For the moment, Libbum will review your PR's whenever there is available time. Feel free to give him a prod if needed.