You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

CONTRIBUTING.md 2.1 KiB

3 years ago
1234567891011121314151617181920212223242526272829303132333435
  1. # How to contribute
  2. Thanks for taking your time to read this. We're thrilled you're reading this because we the help from the community to keep improving this project.
  3. ## Testing
  4. We have a handful of Cucumber features, but most of our testbed consists of RSpec examples. Please write RSpec examples for new code you create.
  5. ## Submitting changes
  6. Please send a [GitHub Pull Request](https://github.com/Hacker0x01/react-datepicker/pull/new/master) with a clear list of what you've done (read more about [pull requests](https://help.github.com/articles/about-pull-requests/)). When you send a pull request, we will love you forever if you include a test to cover your changes. We can always use more test coverage.
  7. Always write a clear log message for your commits. One-line messages are fine for small changes, but bigger changes should look like this:
  8. \$ git commit -m "A summary of the commit > > A paragraph describing what changed and its impact."
  9. ## Coding conventions
  10. Start reading our code, and you'll get the hang of it. We optimize for readability:
  11. - We use prettier for code styling. Don't worry about tabs vs spaces, or how to indent your code.
  12. - We use ESlint for all other coding standards. We try to be consistent and helpful.
  13. - This is open source software. Consider the people who will read your code, and make it look nice for them. It's sort of like driving a car: Perhaps you love doing donuts when you're alone, but with passengers, the goal is to make the ride as smooth as possible.
  14. ## Getting set up
  15. Local development configuration is pretty snappy. Here's how to get set up:
  16. 1. Install/use node >=11.10.1
  17. 2. Run `yarn link` from project root
  18. 3. Run `cd docs-site && yarn link react-datepicker`
  19. 4. Run `yarn build` from project root (at least the first time, this will get you the `dist` directory that holds the code that will be linked to)
  20. 5. Run `yarn install` from project root
  21. 6. Run `yarn start` from project root
  22. 7. Open new terminal window
  23. 8. After each JS change run `yarn build:js` in project root
  24. 9. After each SCSS change run `yarn run css:dev && yarn run css:modules:dev` in project root