File tree Expand file tree Collapse file tree 2 files changed +44
-0
lines changed
Expand file tree Collapse file tree 2 files changed +44
-0
lines changed Original file line number Diff line number Diff line change 1+ # Contributing
2+
3+ > [ !WARNING]
4+ > This guide is a work in progress and may not be complete.
5+
6+ This is a basic contributing guide and is a work in progress.
7+
8+ ## Workflow
9+
10+ 1 . Fork the repository.
11+ 2 . Create a branch in your fork!
12+ 3 . Make your changes.
13+ 4 . [ Test] ( #Testing ) your changes.
14+ 5 . Commit and push your changes.
15+ 6 . Create a PR to this repository.
16+ 7 . Verify the tests pass, otherwise resolve.
17+ 8 . Make sure to keep your branch up-to-date.
18+
19+ ## Testing
20+
21+ GitHub is easier to set up, but you have to push your commits to test.
22+ Running locally is harder to set up, but it is much easier to test; and by far recommended!
23+
24+ ### GitHub
25+
26+ Add your secrets to GitHub Actions Secrets.
27+
28+ When you push your branch to your repository, the [ test.yaml] ( .github/workflows/test.yaml ) should run...
29+
30+ ### Locally
31+
32+ To run actions locally you need to install act: https://nektosact.com/installation/index.html
33+
34+ 1 . Create a ` .secrets ` file with all your secrets in .env file format.
35+ 2 . Run: ` act -j test `
36+
37+ To skip half the tests (` -e event.json ` ) and print your secrets (insecure) run:
38+ ` act -j test --insecure-secrets -e event.json `
39+
40+ To see all available jobs run: ` act -l `
41+
42+ For more information see the documentation: https://nektosact.com/usage/index.html
Original file line number Diff line number Diff line change @@ -206,6 +206,8 @@ If you are experiencing an issue/bug or getting unexpected results you can:
206206
207207Currently, the best way to contribute to this project is to star this project on GitHub.
208208
209+ If you would like to submit a PR, please review the [CONTRIBUTING.md](CONTRIBUTING.md).
210+
209211Additionally, you can support other GitHub Actions I have published :
210212
211213- [Stack Deploy Action](https://github.com/cssnr/stack-deploy-action?tab=readme-ov-file#readme)
You can’t perform that action at this time.
0 commit comments