Skip to content

Latest commit

 

History

History
64 lines (40 loc) · 3.52 KB

CONTRIBUTING.md

File metadata and controls

64 lines (40 loc) · 3.52 KB
Raw

Contributing

The best way to contribute is to help others in the Quill community. This includes:

After becoming familiar with Quill and the codebase, likely through using Quill yourself and making some of the above contributions, you may choose to take on a bigger commitment by:

  • Helping fix bugs
  • Implementing new features
  • Publishing guides, tutorials, and examples
  • Supporting Quill in other ecosystems (Angular, React, etc)

Bug Reports

If you have a question, it is best to ask on StackOverflow and tag with quill. This tag is monitored by Quill maintainers and community members.

Search through Github Issues to see if the bug has already been reported. If so, please comment with any additional information.

Bug reports must include:

  1. Detailed description of faulty behavior
  2. Steps for reproduction or failing test case
  3. Expected and actual behaviors
  4. Platforms (OS and browser combination) affected
  5. Version of Quill

Feature Requests

Search through Github Issues to see if someone has already suggested the feature. If so, please provide support with a reaction and add your own use case.

To open a new feature request, please include:

  1. A detailed description of the feature
  2. Your real world use case requiring the feature
  3. Considerations and behavior differences for other use cases that may benefit from the feature

The more complete and compelling the request, the more likely it will be implemented. Garnering community support will help as well!

Pull Requests

Please check to make sure your plans fall within Quill's scope. This often means opening up a discussion.

Non-code Pull Requests such as typo fixes or documentation improvements are highly encouraged and are often accepted immediately.

Pull Requests modifying public facing interfaces or APIs, including backwards compatible additions, will undergo the most scrutiny, and will almost certainly require a proper discussion of the motivation and merits beforehand. Simply increasing code complexity is a cost not to be taken lightly.

Pull requests must:

  1. Be forked off the develop branch.
  2. Conform to existing coding styles.
  3. Commits are squashed to minimally coherent units of changes.
  4. Are accompanied by tests covering the new feature or demonstrating the bug for fixes.
  5. Serve a single atomic purpose (add one feature or fix one bug).
  6. Introduce only changes that further the PR's singular purpose (ex. do not tweak an unrelated config along with adding your feature).
  7. Not break any existing unit or end to end tests.

Important: By issuing a Pull Request you agree to allow the project owners to license your work under the terms of the License.