Contributing
Contributions welcome — bug reports, feature requests, documentation improvements, and code.
Contributions welcome — bug reports, feature requests, documentation improvements, and code.
Setup
See Development for environment setup and tooling.
Before submitting
- Run tests:
go test ./... - Run linter:
golangci-lint run ./... - Format code:
gofumpt -w . - Make sure new code has test coverage for non-trivial logic
Project design principles
- No unnecessary abstractions — one implementation per concept, no interfaces with one concrete type, no factories
- Stdlib first —
net/httpfor API calls, no HTTP client libraries - Self-contained packages — each internal package has zero imports from other internal packages (except shared types)
- Test co-location —
*_test.gofiles live next to the code they test
Pull request process
- Fork the repo, create a feature branch
- Make your changes, add tests
- Ensure CI passes (tests + lint)
- Open a PR with a clear description
License
MIT — see LICENSE .