Updating, expanding docs. Fixes #36.
This commit is contained in:
parent
fc03bb72d3
commit
745641811e
|
@ -0,0 +1,39 @@
|
||||||
|
# How to Contribute
|
||||||
|
|
||||||
|
The best way to get started is to read through the `Getting Started` and `Example`
|
||||||
|
sections before having a look through the open [issues](https://github.com/js-platform/filer/issues).
|
||||||
|
Some of the issues are marked as `good first bug`, but feel free to contribute to
|
||||||
|
any of the issues there, or open a new one if the thing you want to work on isn't
|
||||||
|
there yet. If you would like to have an issue assigned to you, please send me a
|
||||||
|
message and I'll update it.
|
||||||
|
|
||||||
|
## Setup
|
||||||
|
|
||||||
|
The Filer build system is based on [grunt](http://gruntjs.com/). To get a working build system
|
||||||
|
do the following:
|
||||||
|
|
||||||
|
```
|
||||||
|
npm install
|
||||||
|
npm install -g grunt-cli
|
||||||
|
```
|
||||||
|
|
||||||
|
You can now run the following grunt tasks:
|
||||||
|
* `grunt check` will run [JSHint](http://www.jshint.com/) on your code (do this before submitting a pull request) to catch errors
|
||||||
|
* `grunt develop` will create a single file version of the library for testing in `dist/idbfs.js`
|
||||||
|
* `grunt release` like `develop` but will also create a minified version of the library in `dist/idbfs.min.js`
|
||||||
|
|
||||||
|
Once you've done some hacking and you'd like to have your work merged, you'll need to
|
||||||
|
make a pull request. If you're patch includes code, make sure to check that all the
|
||||||
|
unit tests pass, including any new tests you wrote. Finally, make sure you add yourself
|
||||||
|
to the `AUTHORS` file.
|
||||||
|
|
||||||
|
## Tests
|
||||||
|
|
||||||
|
Tests are writting using [Jasmine](http://pivotal.github.io/jasmine/). You can run the tests
|
||||||
|
in your browser by opening the `tests` directory. You can also run them
|
||||||
|
[here](http://js-platform.github.io/idbfs/tests/).
|
||||||
|
|
||||||
|
## Communication
|
||||||
|
|
||||||
|
If you'd like to talk to someone about the project, you can reach us on irc.mozilla.org in the
|
||||||
|
mofodev channel. Look for "ack" or "humph".
|
Loading…
Reference in New Issue