tikiwiki/packages/tiki-pkg-tikimanager/gitonomy/gitlib/.github/CONTRIBUTING.md
2023-11-20 20:52:04 +00:00

33 lines
1.3 KiB
Markdown
Executable File

# CONTRIBUTION GUIDELINES
Contributions are **welcome** and will be fully **credited**.
We accept contributions via pull requests on GitHub. Please review these guidelines before continuing.
## Guidelines
* Please follow the [PSR-12 Coding Style Guide](https://www.php-fig.org/psr/psr-12/), enforced by [StyleCI](https://styleci.io/).
* Ensure that the current tests pass, and if you've added something new, add the tests where relevant.
* Send a coherent commit history, making sure each commit in your pull request is meaningful.
* You may need to [rebase](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) to avoid merge conflicts.
* If you are changing or adding to the behaviour or public API, you may need to update the docs.
* Please remember that we follow [Semantic Versioning](https://semver.org/).
## Running Tests
First, install the dependencies using [Composer](https://getcomposer.org/):
```bash
$ composer install
```
Then run [PHPUnit](https://phpunit.de/):
```bash
$ vendor/bin/phpunit
```
* A script `test-git-version.sh` is available in repository to test gitlib against many git versions.
* The tests will be automatically run by [GitHub Actions](https://github.com/features/actions) against pull requests.
* We also have [StyleCI](https://styleci.io/) set up to automatically fix any code style issues.