Skip to content

Commit 010ea2e

Browse files
committed
Update README.md
1 parent 7558cee commit 010ea2e

File tree

2 files changed

+44
-0
lines changed

2 files changed

+44
-0
lines changed

CONTRIBUTING.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
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

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,8 @@ If you are experiencing an issue/bug or getting unexpected results you can:
206206

207207
Currently, 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+
209211
Additionally, 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)

0 commit comments

Comments
 (0)