4chan-x/CONTRIBUTING.md
2012-09-24 22:37:33 +02:00

46 lines
1.3 KiB
Markdown

## Reporting bugs
1. Make sure your **browser** & **4chan X** are up to date.
2. Disable your other extensions & scripts.
3. If your issue persists:
1. Report precise steps to reproduce the problem.
2. Report console errors, if any.
3. Report browser and browser version.
Open your console with:
- `Ctrl + Shift + J` on Chrome & Firefox
- `Ctrl + Shift + O` on Opera.
***
## Development & Contribution
### Get started
- Clone 4chan X.
- `cd` into it.
- Install [node.js](http://nodejs.org/).
- Install [CoffeeScript](http://coffeescript.org/) with `npm install -g coffee-script`.
- Install [Grunt](http://gruntjs.com/) with `npm install -g grunt`.
- Install [grunt-exec](https://npmjs.org/package/grunt-exec) with `npm install grunt-exec`.
- Install [grunt-image-embed](https://npmjs.org/package/grunt-image-embed) with `npm install grunt-image-embed`.
### Build
- Build with `grunt`.
- For development (continuous builds), run `grunt watch`.
### Release
- To upgrade, edit the version in `grunt.js` and run `grunt upgrade`.
Note: this is only used to release new 4chan X versions, and is not needed or wanted in pull requests.
### Contribute
- Edit the CoffeeScript source.
- Build the JavaScript.
- If the edits affect regular users, edit the changelog.
- Fork the repo.
- Send a pull request.