First off, thank you for considering contributing! We welcome issues, bugfixes, improvements, and new features. This document outlines the standards and process we follow to keep the codebase clean, stable, and maintainable.
-
Branch names must be descriptive and start with either
fix/orfeature/.- Example:
fix/login-redirect,feature/signup-form - Follow the Conventional Commits standard for determining branch prefixes
- Example:
-
Commits must follow the Conventional Commits specification:
-
Squash your commits into one logical unit before submitting a pull request.
Before opening a pull request:
- Make sure your branch is targeting
main - Your PR title must be descriptive and must not include emojis.
- Your PR title must follow the Conventional Commits specification:
<type>[optional scope]: <description>
[optional body]
[optional footer(s)]
Examples:
- fix(auth)!: correct OAuth2 redirect
- feat(cli): add generate-config subcommand
- Your PR description must explain:
- What you changed.
- Why you made the change.
- Which issue it closes (use
closes #xxxxsyntax).
- Make sure all checks pass:
npm run build(for docs-related changes)go build ./...andgolangci-lint run(for Go code)- All unit tests pass.
- Unit test coverage does not decrease.
If you’re unsure about anything, feel free to file an issue.
Thanks for helping improve this project!