CONTRIBUTING.md

Contributing

Any contribution to this project is very welcome, especially holidays from new countries or updates.

Welcome.

Contributing changes to holidays.yaml

If you like to add or change data please take a look at holidays.yaml specification.

1. Fork the project
2. Create a branch for your changes
3. Modify data/holidays.yaml for holiday data and/or data/names.yaml for translations as appropriate
4. Generate the Json file from the yaml files with

   npm run yaml
   

5. Run the samples file with the country containing your changes, e.g. here for "at.w" (Austria, Vienna)

   node test/sample.js "at.w" 2016
   

   To check translation, e.g. English

   node test/sample.js "at.w" 2016 en
   

6. Run the tests with

   npm test
   

7. If a new country was added there might be failing tests in Step 5.
   Generate these with:

   mocha test/all.mocha.js --writetests
   

   Now check any changes with git diff test/fixtures. Make sure that your changes did not affect other countries.
8. Push your branch to GitHub and submit a pull request
9. Monitor the pull request to make sure the Travis build succeeds. If it fails simply make the necessary changes to your branch and push it. Travis will re-test the changes.

That's it. If you don't feel comfortable forking the project or modifying the YAML you can also submit an issue that includes the appropriate holiday data and required rules.

Please do not forget to name your source of information.

Thanks!