Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
106 lines (77 loc) · 2.15 KB

CONTRIBUTING.md

File metadata and controls

106 lines (77 loc) · 2.15 KB
Raw
summary Contribution guidelines including quality gates and PR workflow.
read_when
Preparing your first contribution.
Opening a pull request.
Understanding project conventions.

Contributing

Thank you for your interest in contributing! This guide covers how to contribute effectively.

Quick Start

  1. Fork and clone the repository:
git clone <repo-url>
cd <project-name>
  1. Build the project:
# adapt: replace with project build command
  1. Run tests:
# adapt: replace with project test command
  1. Make your changes and test locally.

Pull Request Workflow

Before Submitting

  • Code compiles without warnings
  • Tests pass
  • No linter warnings
  • Code formatted
  • Documentation updated (if behavior changes)
  • Commit messages are clear and descriptive

Opening a PR

  1. Create a feature branch:
git checkout -b feature/my-feature
  1. Make commits with clear messages:
git commit -m "feat: add new feature"
  1. Push and open PR:
git push origin feature/my-feature
  1. In your PR description:
    • Explain what changed and why
    • Reference any related issues
    • Note any breaking changes

PR Review Process

  • All PRs require at least one review
  • Address review feedback promptly
  • CI must pass before merge
  • Maintainers may squash commits on merge

Local Quality Gates

Run these before pushing:

# adapt: replace with project-specific commands
bin/validate-docs

Code Style

  • Follow project idioms and formatting conventions
  • Run linters and fix all warnings
  • Keep functions focused and small
  • Use meaningful variable names
  • See docs/STYLE.md for full conventions

Documentation

If your change affects user-facing behavior:

  • Update README.md for user-facing changes
  • Update docs/PRIMARY_TODO.md if architecture changes
  • Add/update examples if applicable

Getting Help

  • Open an issue for bugs or feature requests
  • Join discussions in existing issues
  • Check docs/ for architecture and setup information

License

By contributing, you agree that your contributions will be licensed under the project's license.