Skip to content

Latest commit

 

History

History
54 lines (35 loc) · 2.88 KB

CONTRIBUTING.md

File metadata and controls

54 lines (35 loc) · 2.88 KB

Contributing to Panurus

We welcome contributions to Panurus!

Note that we follow the LFDT Charter. All new inbound code contributions to the project shall be made under the Apache License, Version 2.0. All outbound code will be made available under the Apache License, Version 2.0.

Code of Conduct

Please note that we have a Code of Conduct. Please follow it in all your interactions with the project.

How to Contribute

  1. Fork the repository on GitHub.
  2. Clone your fork locally.
  3. Create a new branch for your feature or bugfix.
  4. Make your changes.
  5. Run tests (see Testing Guide) to ensure your changes don't break anything.
  6. Commit your changes using the sign-off flag (-s).
  7. Push your branch to your fork.
  8. Submit a Pull Request (PR) to the main branch of the upstream repository.

Good first issues

We maintain a set of issues labeled "good first issue" to help new contributors find approachable tasks and get started quickly. If you're contributing for the first time, please consider picking one of these issues:

  • Browse the current list here: https://github.com/LFDT-Panurus/panurus/issues?q=is%3Aissue+state%3Aopen+label%3A%22good+first+issue%22
  • Leave a comment on the issue saying you'd like to work on it and ask to be assigned.
  • If you need clarification or guidance, ask on our Discord channel (#panurus) or comment on the issue — maintainers and community members are happy to help.
  • Keep your first PR small and focused. Follow the project guidelines: run tests, sign your commits (-s), and rebase to keep a linear history.

Detailed Development Guidelines

Please refer to the Development Guidelines for detailed information on:

Security

Vulnerabilities must not be reported through public issues — follow the Security Policy instead.

The security practices the project holds itself to are recorded as a self-assessment against the OpenSSF Security Baseline, including the controls that are still unmet. If your contribution closes one of those gaps, reference the corresponding OSPS-* control in the pull request.

Reporting Issues

If you find a bug or have a feature request, please search the Issues to see if it has already been reported. If not, please open a new issue.

Community

Join us on Discord in the #panurus channel.