Improve CONTRIBUTING.md

This commit is contained in:
Riccardo Bartoli 2016-05-28 17:08:06 +01:00
parent beadd8e14f
commit ec068ca3a4
1 changed files with 29 additions and 11 deletions

View File

@ -1,6 +1,12 @@
# Contributing # Contributing
From opening a bug report to creating a pull request: every contribution is
appreciated and welcome. If you're planning to implement a new feature or change
the api please create an issue first. This way we can ensure that your precious
work is not in vain.
## Issues
Most of the time, if webpack is not working correctly for you it is a simple configuration issue. Most of the time, if webpack is not working correctly for you it is a simple configuration issue.
If you are still having difficulty after looking over your configuration carefully, please post If you are still having difficulty after looking over your configuration carefully, please post
@ -9,26 +15,32 @@ that include your webpack.config.js and relevant files are more likely to receiv
**If you have discovered a bug or have a feature suggestion, feel free to create an issue on Github.** **If you have discovered a bug or have a feature suggestion, feel free to create an issue on Github.**
## Contributing to the webpack ecosystem
If you have created your own loader/plugin please include it on the relevant If you have created your own loader/plugin please include it on the relevant
documentation pages: documentation pages:
[List of loaders](https://webpack.github.io/docs/list-of-loaders.html) [List of loaders](https://webpack.github.io/docs/list-of-loaders.html)
[List of plugins](https://webpack.github.io/docs/list-of-plugins.html) [List of plugins](https://webpack.github.io/docs/list-of-plugins.html)
### Documentation ## Setup
webpack is insanely feature rich and documentation is a huge time sink. We ```bash
greatly appreciate any time spent fixing typos or clarifying sections in the git clone https://github.com/webpack/webpack.git
documentation. cd webpack
npm install
npm link
npm link webpack
```
To run the entire test suite use:
```bash
npm test
```
## Submitting Changes ## Submitting Changes
From opening a bug report to creating a pull request: every contribution is
appreciated and welcome. If you're planning to implement a new feature or change
the api please create an issue first. This way we can ensure that your precious
work is not in vain.
After getting some feedback, push to your fork and submit a pull request. We After getting some feedback, push to your fork and submit a pull request. We
may suggest some changes or improvements or alternatives, but for small changes may suggest some changes or improvements or alternatives, but for small changes
your pull request should be accepted quickly. your pull request should be accepted quickly.
@ -38,3 +50,9 @@ Some things that will increase the chance that your pull request is accepted:
* Write tests * Write tests
* Follow the existing coding style * Follow the existing coding style
* Write a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) * Write a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)
## Documentation
webpack is insanely feature rich and documentation is a huge time sink. We
greatly appreciate any time spent fixing typos or clarifying sections in the
documentation.