Skip to content

Latest commit

 

History

History
66 lines (51 loc) · 2.45 KB

CONTRIBUTING.adoc

File metadata and controls

66 lines (51 loc) · 2.45 KB

llm-rate-keeper Contribution Guidelines

Thank you so much for wanting to contribute to llm-rate-keeper! Here are a few important things you should know about contributing:

  1. API changes require discussion, use cases, etc. Code comes later.

  2. Pull requests are great for small fixes for bugs, documentation, etc.

  3. Code contributions require updating relevant documentation.

This project takes all contributions through pull requests. Code should not be pushed directly to master.

The following guidelines apply to all contributors.

Types of contributions

All types of contributions from minor documentation changes to new capabilities, performance improvement, extending test etc., are all welcome.

Making Changes

  • Fork the llm-rate-keeper repository

  • Make your changes and push them to a topic branch in your fork

  • See our commit message guidelines further down in this document

  • Submit a pull request to the repository

  • Update llm-rate-keeper GITHUB issue with the generated pull request link

General Guidelines

  • Only one logical change per commit

  • Do not mix whitespace changes with functional code changes.

  • Do not mix unrelated functional changes.

  • When writing a commit message:

    • Describe why a change is being made

    • Do not assume the reviewer understands what the original problem was

    • Do not assume the code is self-evident/self-documenting

    • Describe any limitations of the current code

  • Any significant changes should be accompanied by tests.

  • The project already has good test coverage, so look at someofthe existing tests if you’re unsure how to go about it.

  • Please squash all commits for a change into a single commit (this can be done using git rebase -i).

Commit Message Guidelines

  • Provide a brief description of the change in the first line.

  • Insert a single blank line after the first line

  • Provide a detailed description of the change in the following lines, breaking paragraphs where needed.

  • The first line should be limited to 50 characters and should not end in a period.

  • Subsequent lines should be wrapped at 72 characters.

Java Guidelines

  • Please make sure

    • source code is always formatted before commit.

    • you remove all unused imports.

    • usage of @Override

  • Please avoid

    • trailing whitespace on all lines.

    • all unused imports.

    • empty blocks