Skip to content

CONTRIBUTION.md

Latest commit

 

History

History
117 lines (83 loc) · 3.28 KB

CONTRIBUTION.md

File metadata and controls

117 lines (83 loc) · 3.28 KB

Contribution Guidelines

Development

Code of Conduct

We are committed to providing a friendly, safe, and welcoming environment for all contributors. Please read and follow our Code of Conduct.

Getting Started

  1. Fork the repository on GitHub.
  2. Clone your fork locally: 
    git clone https://github.com/YOUR-USERNAME/agentgateway.git
cd agentgateway
  3. Add the upstream repository as a remote: 
    git remote add upstream https://github.com/agentgateway/agentgateway.git
  4. Create a new branch for your changes: 
    git checkout -b feature/your-feature-name

Development Environment Setup

See the DEVELOPMENT.md file for more information.

Making Changes

Coding Standards

  • Rust Code:

    • Run make lint before submitting your changes
    • Ensure all tests pass with make test
    • Add tests for new functionality

  • UI Code:

    • Follow the project's ESLint configuration
    • Run npm run lint before submitting changes
    • Ensure all tests pass with npm test
    • Add tests for new functionality

Commit Guidelines

We follow the Conventional Commits specification:

  • feat: A new feature
  • fix: A bug fix
  • docs: Documentation only changes
  • style: Changes that do not affect the meaning of the code
  • refactor: A code change that neither fixes a bug nor adds a feature
  • perf: A code change that improves performance
  • test: Adding missing tests or correcting existing tests
  • chore: Changes to the build process or auxiliary tools

Pull Request Process

  1. Update your fork with the latest changes from upstream:

    git fetch upstream
git rebase upstream/main

  2. Push your changes to your fork:

    git push origin feature/your-feature-name

  3. Create a Pull Request from your fork to the main repository.

  4. Fill out the PR template with all required information.

  5. Address review comments if requested by maintainers.

  6. Update your PR if needed:

    git add .
git commit -m "address review comments"
git push origin feature/your-feature-name

  7. Once approved, a maintainer will merge your PR.

Documentation

  • Update documentation for any changes to APIs, CLIs, or user-facing features
  • Add examples for new features
  • Update the README if necessary
  • Add comments to your code explaining complex logic

Releasing

Only project maintainers can create releases. The process is:

  1. Update version numbers in relevant files
  2. Create a release branch
  3. Create a tag for the release
  4. Build and publish artifacts
  5. Create a GitHub release with release notes

Community

License

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

Questions?

If you have any questions about contributing, please open an issue or reach out to the maintainers.