Contributing to OpenPRoT

Thank you for your interest in contributing to the OpenPRoT project!

Contribution Process

Before you begin, please review our Development Process for details on our RFC process for large changes and our standard requirements for pull requests.

Contributor License Agreement

  • Use of OpenPRoT requires no CLA.
  • Contributions to OpenPRoT must have signed the CHIPS CLA.

Code of Conduct

The code of conduct can be found here.

Development Setup

  1. Clone the repository.
  2. Use the Pigweed workflow launcher pw or bazel for common tasks:
    • ./pw presubmit - Run presubmit checks: formatting, license checks, C/C++ header checks, and clippy.
    • ./pw format - Run the code formatters.
    • bazel test //... - Run all tests.
    • bazel build //docs - Build documentation.

Code Style

  • Follow the coding style guide.
  • Run ./pw presubmit to check for lints and ensure all tests pass.

Documentation

  • Update documentation in the docs/ directory.
  • Build docs with bazel build //docs.
  • Documentation is built with mdbook.

Issues

Please report issues on the GitHub issue tracker.