I have changed my branching model recently (November 2013)! Previously the latest version was always in develop, and pull request had to be made on this branch. This is no longer the case!
The latest version is always in the master branch.
Please provide a test for any new feature (see the testing section below).
Before you start implementing new features, please create an issue about it first and discuss your intent.
It might be something that someone else is already implementing or that goes against the concepts of Dropzone, and I really hate rejecting pull requests others spent hours writing on.
The first thing you need to do, is to install the developer dependencies:
$ npm installThis will install all the tools you need to compile the source files and to test the library.
Dropzone is written in Coffeescript and Stylus so do not make changes to the Javascript or CSS files
I will not merge requests written in Javascript or CSS.
Please don't include compiled .js or .css files in your pull requests but only
.coffee or .styl files. That way pull requests aren't polluted and I can see
immediately what you changed.
To build the library use grunt.
$ grunt -h # Displays available options
$ grunt # compiles all coffeescript and stylus files
$ grunt watch # watches for changes and builds on the flyI recommend using
grunt watchwhen you begin developing. This way you can't forget to compile the source files and will avoid headaches.
To test the library, open test/test.html in your browser or type npm test
which will run the tests in your console in a headless browser.
The tests are also written in coffeescript in the test/test.coffee file,
and compiled with grunt js or grunt watch.
- Thanks for contributing!*