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

1.3 KiB
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, enforced by StyleCI.
  • 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 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.

Running Tests

First, install the dependencies using Composer:

$ composer install

Then run PHPUnit:

$ 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 against pull requests.
  • We also have StyleCI set up to automatically fix any code style issues.