| 1 | # Contributing
|
| 2 |
|
| 3 | Thank you for wanting to contribute. stylelint *needs* community contributions to continue to improve.
|
| 4 |
|
| 5 | If you like stylelint and open-source software (since you're reading this, you almost certainly do), please consider taking some time to pitch in. Not only will you help stylelint thrive, but you may learn a thing or two — about CSS, PostCSS, Node, ES2015, unit testing, open-source software, and more.
|
| 6 |
|
| 7 | To help out, you can:
|
| 8 |
|
| 9 | - get involved in any open [issue](https://github.com/stylelint/stylelint/issues) or [pull request](https://github.com/stylelint/stylelint/pulls)
|
| 10 | - improve our [support for non-standard syntaxes](docs/about/syntaxes.md)
|
| 11 | - create, enhance and debug rules using [our guide](docs/developer-guide/rules.md)
|
| 12 | - improve the [documentation](docs/)
|
| 13 | - add new tests to *absolutely anything*
|
| 14 | - improve the [performance of rules](docs/developer-guide/rules.md#improve-the-performance-of-a-rule)
|
| 15 | - open [new issues](https://github.com/stylelint/stylelint/issues/new/choose) about your ideas for making stylelint better
|
| 16 | - create or contribute to [integrations](docs/user-guide/integrations/editor.md), like our plugin for [VS Code](https://github.com/stylelint/vscode-stylelint)
|
| 17 |
|
| 18 | **We want to do everything we can to encourage contributions!** So if you want to participate but don't end up doing it for one reason or another, please [file an issue](https://github.com/stylelint/stylelint/issues/new) and give us feedback about what we could do to encourage you better.
|
| 19 |
|
| 20 | ## Code contributions
|
| 21 |
|
| 22 | You should first [create a new issue](https://github.com/stylelint/stylelint/issues/new/choose) so that we can discuss your new feature, bug fix or change.
|
| 23 |
|
| 24 | To start coding, you'll need:
|
| 25 |
|
| 26 | - a minimum of [Node.js](https://nodejs.org/en/) v10, though we do recommend using the latest LTS release
|
| 27 | - the latest [npm](https://www.npmjs.com/)
|
| 28 |
|
| 29 | Then:
|
| 30 |
|
| 31 | 1. [Fork and clone](https://guides.github.com/activities/forking/) the stylelint repository.
|
| 32 | 2. Install all the dependencies with `npm ci`.
|
| 33 |
|
| 34 | ### Run tests
|
| 35 |
|
| 36 | Next, you'll want to run the tests using `npm test`.
|
| 37 |
|
| 38 | However, this runs all 25,000+ unit tests and also linting.
|
| 39 |
|
| 40 | You can use interactive testing prompt to run tests for just a chosen set of files (which you'll want to do during development). For example, to run the tests for just the `color-hex-case` and `color-hex-length` rules:
|
| 41 |
|
| 42 | 1. Run `npm run watch` to start the interactive testing prompt.
|
| 43 | 2. Press `p` to filter by a filename regex pattern.
|
| 44 | 3. Enter `color-hex-case|color-hex-length` i.e. each rule name separated by the pipe symbol (`|`).
|
| 45 |
|
| 46 | You can find more information about testing on the [Jest website](https://jestjs.io/).
|
| 47 |
|
| 48 | ### Write code
|
| 49 |
|
| 50 | With the interactive testing prompt running, you can write the code to fix the bug or add the new feature confident that things are working as expected. You'll find more guidance on how we write code in the [Developer guide](docs/developer-guide/rules.md).
|
| 51 |
|
| 52 | ### Format code
|
| 53 |
|
| 54 | We use [Prettier](https://prettier.io/) (with [a Husky and lint-staged precommit](https://prettier.io/docs/en/precommit.html)) to format your code automatically.
|
| 55 |
|
| 56 | Alternatively, you can:
|
| 57 |
|
| 58 | - trigger the pretty-printing all the files using `npm run prettier:fix`
|
| 59 | - use a [Prettier editor integration](https://prettier.io/docs/en/editors.html)
|
| 60 |
|
| 61 | ### Open a pull request
|
| 62 |
|
| 63 | When you have something to share, it's time to [open a pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork).
|
| 64 |
|
| 65 | After we review and merge your pull request, we'll invite you to become a maintainer of the stylelint organization. You'll then be able to help manage issues, pull requests and releases. You'll also be able to work on the stylelint repository rather than your fork.
|
| 66 |
|
| 67 | ## Financial contributions
|
| 68 |
|
| 69 | We welcome financial contributions in full transparency on our [Open Collective](https://opencollective.com/stylelint).
|
| 70 |
|
| 71 | Anyone can file an expense. We will "merge" the expense into the ledger if it makes sense for the development of the community. Open Collective then reimburses the person who filed the expense.
|
| 72 |
|
| 73 | You can financially support us by becoming a:
|
| 74 |
|
| 75 | - [backer](https://opencollective.com/stylelint#backer)
|
| 76 | - [sponsor](https://opencollective.com/stylelint#sponsor)
|