setup-php/.github/CONTRIBUTING.md

71 lines
2.0 KiB
Markdown
Raw Normal View History

2019-09-22 13:46:51 +07:00
# Contributing to setup-php
## Contributor Code of Conduct
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.
## Workflow
* Fork the project.
* Make your bug fix or feature addition.
2020-10-05 15:25:56 +07:00
* Add tests for it, so we don't break it in a future version unintentionally.
2020-05-16 12:58:01 +07:00
* If editing the scripts, create a demo integration test.
* Send a pull request to the develop branch with all the details.
2019-09-22 13:46:51 +07:00
Please make sure that you have [set up your user name and email address](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup) for use with Git. Strings such as `silly nick name <root@localhost>` look really stupid in the commit history of a project.
2020-05-16 12:58:01 +07:00
Due to time constraints, you may not always get a quick response. Please do not take delays personally and feel free to remind.
2019-09-22 13:46:51 +07:00
## Coding Guidelines
## Using setup-php from a Git checkout
The following commands can be used to perform the initial checkout of setup-php:
```bash
$ git clone https://github.com/shivammathur/setup-php.git
$ cd setup-php
```
Install setup-php dependencies using [npm](https://www.npmjs.com/):
```bash
$ npm install
```
2020-10-31 16:25:27 +07:00
If you are using `Windows` configure `git` to handle line endings.
```cmd
git config --local core.autocrlf true
```
This project comes with `.prettierrc.json` and `eslintrc.json` configuration files. Please run the following commands to fix and verify the code quality.
```bash
$ npm run format
$ npm run lint
```
2019-09-22 13:46:51 +07:00
## Running the test suite
After following the steps shown above, The `setup-php` tests in the `__tests__` directory can be run using this command:
```bash
$ npm test
```
2019-11-25 23:36:40 +07:00
## Creating a release
Create a release before you push your changes.
```bash
$ npm run release
```
2019-09-22 13:46:51 +07:00
## Reporting issues
2019-11-03 11:41:44 +07:00
Please submit the issue using the appropriate template provided for a bug report or a feature request:
2019-09-22 13:46:51 +07:00
2020-05-16 12:58:01 +07:00
* [Issues](https://github.com/shivammathur/setup-php/issues)