Skip to content

Latest commit

 

History

History
21 lines (17 loc) · 1.14 KB

CONTRIBUTING.md

File metadata and controls

21 lines (17 loc) · 1.14 KB

Contributing

Report ordinary bugs with native OS/shell versions, candidate revision, exact sanitized command, exit code and relevant output through GitHub issues. Remove credentials and personal paths. Follow SECURITY.md for vulnerabilities.

For changes, use a branch and inspect the existing script conventions. Keep Windows PowerShell 5.1 and macOS Bash 3.2 compatibility explicit. Run python tests/test_package.py (or python3) without installing real products. Use SETUP_TEST_SHELL to select a shell. Keep docs/validation.md and the candidate receipt honest about actual native platforms and mocked substeps.

Test error propagation, preview/consent, repeated execution, paths with spaces, unsupported conditions and partial success. Avoid dependencies that require a global install merely to run the test suite. Confirm source ZIP extraction is self-contained and excludes caches, secrets and local paths.

A local patch/test result is not upstream publication. Submit a reviewed PR only with the repository owner's authorization and include tests and residuals.