Skip to content

Latest commit

 

History

History
50 lines (30 loc) · 2.11 KB

CONTRIBUTING.md

File metadata and controls

50 lines (30 loc) · 2.11 KB
Raw

Contributing

Hi there.

Thanks for your interest in Parsley and your will to contribute. You're welcome!

First thing: make sure you are using the latest official release.

Questions?

Please ask questions on StackOverflow and be sure to include the parsley.js tag. Please provide an example, starting for example from this jsfiddle

Issues?

If you believe you have found a bug in parsley, please provide an example, starting for example from this jsfiddle.

This makes it possible for you to be sure you have isolated the issue to a minimal case. It also makes it much easier for us to understand your issue. Sometimes the issue is completely different than what you would expect and only an actual example can lead to a solution.

Pull requests?

Here are a few simple rules you'll have to follow in order to ease code reviews, discussions and PR merging.

  1. You MUST follow Parsley coding standard. It basically follows these popular rules except that functions are followed by one space on Parsley. Use two spaces as tabs.

  2. You MUST write / update tests for each code contribution you do

  3. You MUST commit a passing test-suite

  4. You SHOULD write documentation

Please, write commit messages that make sense, and rebase your branch before submitting your Pull Request.

One may ask you to squash your commits too. This is used to "clean" your Pull Request before merging it (we don't want commits such as fix tests, fix 2, fix 3, etc.).

Also, while creating your Pull Request on GitHub, you MUST write a description which gives the context and/or explains why you are creating it.

Thank you!

Inspired by http://williamdurand.fr/2013/07/04/on-open-sourcing-libraries/