add notes about contributing (#114)
This commit is contained in:
13
README.md
13
README.md
@@ -2,9 +2,18 @@
|
||||
|
||||
[](https://github.com/exercism/8th/actions?query=workflow%3Aconfiglet) [](https://github.com/exercism/8th/actions?query=workflow%3Atest)
|
||||
|
||||
Exercism exercises in 8th.
|
||||
Exercism exercises in [8th](https://8th-dev.com/manual.html).
|
||||
|
||||
## Testing
|
||||
## CONTRIBUTING
|
||||
|
||||
### Caution: CI will fail for PRs coming from forked repos
|
||||
|
||||
This track [uses its own test runner for CI](https://github.com/exercism/8th/blob/1176bfbd9457f51556c77b8cc26408d718d1b4d6/.github/workflows/test.yml#L18).
|
||||
This requires a secret token to grant access.
|
||||
I'm not sure how this mechanism works, but it means that, for PRs originating from _a fork of this repo_, access cannot be granted and CI will fail: CI will only pass for PRs merging an exercism/8th branch.
|
||||
Thus only people in [the exercism/8th team](https://github.com/orgs/exercism/teams/8th) (i.e. those with write access to this repo) can successfully create a branch, submit a PR, and have CI pass.
|
||||
|
||||
### Testing
|
||||
|
||||
To test the exercises, run `./bin/test`.
|
||||
This command will iterate over all exercises and check to see if their exemplar/example implementation passes all the tests.
|
||||
|
||||
Reference in New Issue
Block a user