Thanks — we welcome focused, well-tested contributions.
Before you start
- Open an issue for non-trivial work or anything that changes behavior.
- Reference related issues in your PR.
Branching & PRs
- Fork, branch from main and name branches {issue-number}/{short-description}.
- Open a PR against main. Link the issue in the PR description.
- Keep PRs small and single-purpose.
Development checklist (PR author)
- Run the relevant runner locally and verify behavior.
- Add tests for new behavior where applicable.
- Lint and format code according to existing examples in the repo.
- Write a short, clear PR description and list what reviewers should verify.
- Ensure CI passes before requesting final review.
Review & merging
- Expect at least one approving review and passing CI.
- Maintainers will merge after review and CI are green.
- Squash or rebase as requested by reviewers.
Style & scope
- Add scripts under the appropriate folder (sh/ps1/cmd) and follow existing examples.
- Prefer minimal, readable shell code; aim for maintainability and cross-platform clarity.
Legal & conduct
- Contributions are under this repo’s license. Include a DCO sign-off if required.
- Follow the project Code of Conduct.
If unsure, open an issue or a discussion first.