Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
114 lines (84 loc) · 2.99 KB

CONTRIBUTING.md

File metadata and controls

114 lines (84 loc) · 2.99 KB

Contributing to Klime Ruby SDK

Thank you for your interest in contributing to the Klime Ruby SDK!

Important: Repository Structure

This repository is a read-only mirror of our internal monorepo. We develop and maintain the SDK internally, then mirror releases to this public repository.

What This Means for Contributors

  • Pull requests are welcome and will be reviewed by our team
  • If accepted, we'll manually port your changes to our internal monorepo
  • Your changes will appear in this repository with the next release
  • You'll be credited as a co-author in the commit

How to Contribute

Reporting Bugs

  1. Check if the bug has already been reported in Issues
  2. If not, create a new issue with:
    • A clear, descriptive title
    • Steps to reproduce the bug
    • Expected vs actual behavior
    • Your environment (Ruby version, OS, etc.)
    • Any relevant code snippets or error messages

Suggesting Features

  1. Check if the feature has already been suggested in Issues
  2. Create a new issue describing:
    • The problem you're trying to solve
    • Your proposed solution
    • Any alternatives you've considered

Submitting Code Changes

  1. Fork this repository
  2. Create a feature branch (git checkout -b feat/amazing-feature)
  3. Make your changes
  4. Write or update tests as needed
  5. Ensure all tests pass (bundle exec rake test)
  6. Commit using Conventional Commits: 
    feat: add new tracking method
fix: handle edge case in batch processing
docs: update README examples
  7. Push to your fork and open a Pull Request

Pull Request Guidelines

  • Provide a clear description of what the PR does
  • Reference any related issues
  • Include tests for new functionality
  • Update documentation if needed
  • Keep PRs focused - one feature or fix per PR

Development Setup

# Clone your fork
git clone https://github.com/YOUR_USERNAME/klime-ruby.git
cd klime-ruby

# Install dependencies
bundle install

# Run tests
bundle exec rake test

# Run linter
bundle exec rubocop

Project Structure

klime-ruby/
├── lib/
│   ├── klime.rb          # Main entry point
│   └── klime/
│       ├── client.rb     # Main client implementation
│       ├── event.rb      # Event types
│       └── version.rb    # Version constant
├── test/
├── klime.gemspec         # Gem specification
└── README.md

Code Style

  • We follow the Ruby Style Guide
  • Use meaningful variable and method names
  • Add YARD documentation for public APIs
  • Keep methods small and focused

Running Tests

# Run all tests
bundle exec rake test

# Run specific test file
ruby -Ilib:test test/test_client.rb

Questions?

If you have questions about contributing, feel free to open an issue and we'll be happy to help!

License

By contributing, you agree that your contributions will be licensed under the MIT License.