Contributing to PAGI
Thanks for your interest in contributing to PAGI!
Quick Start
- Fork the repository
- Make your changes
- Run tests (see below)
- Submit a pull request
What to Contribute
Bug fixes and documentation corrections - Submit a PR directly. For bugs, please include a failing test case demonstrating the issue.
New features, API changes, or significant refactors - Open an issue first to discuss the approach. This ensures your time isn't wasted on something that might not fit the project's direction.
Code Style
Follow the existing code style. Key conventions:
- 4-space indentation (no tabs)
- Opening braces on same line
- Descriptive variable names
- Keep methods focused and reasonably sized
When in doubt, match what you see in the surrounding code.
Running Tests
The spec distribution has minimal tests (the PAGI::Spec::* POD is
generated at build time and not present in the repo). prove -l t/ runs
the load test against the one shippable module, PAGI.pm.
prove -l t/ # Run the spec distribution tests
AI-Assisted Contributions
AI tools are welcome in your workflow. However, you're responsible for understanding, testing, and standing behind any code you submit.
Expectations
This is a volunteer project maintained in my spare time. I cannot commit to timelines for reviewing PRs or responding to issues.
If your organization needs priority support, expedited PR review, or custom development, I'm available for contract work. Contact jjnapiork@cpan.org to discuss.
Questions?
Open an issue on GitHub or reach out to the maintainer.