Contributing to Concierge::Sessions

Thank you for your interest in contributing to Concierge::Sessions.

Bug Reports

Open an issue at https://github.com/bwva/Concierge-Sessions/issues with:

• Perl version (perl -v)
• Operating system
• Module version
• Minimal reproduction steps
• Expected vs actual behaviour

Feature Requests

Open an issue describing the use case and proposed behaviour. Discussion before implementation helps ensure alignment with the project direction.

Pull Requests

1. Fork the repository
2. Create a topic branch from main
3. Make your changes
4. Ensure all tests pass:

perl Makefile.PL
make test           # Core tests (t/)
prove -l xt/        # Author tests (xt/)

1. Submit a pull request against main

Code Style

• Perl v5.36+ features (signatures, use v5.36)
• Tabs for indentation in Perl source
• Return hashrefs with success key for all public methods
• POD documentation for public API changes
• ASCII-only in POD sections (see xt/pod-no-nonascii.t)

Tests

• New features should include tests in t/
• Tests that require real-time waits (e.g., sleep) belong in xt/
• Author tests in xt/ should skip under AUTOMATED_TESTING
• Use Test2::V0

License

By contributing, you agree that your contributions will be licensed under the Artistic License 2.0.