Contents

# Contributing

## Adding a feature

1. Open an issue and explain what you're planning to do. It is better to discuss new idea first,
   rather when diving into code.
2. Add some tests.
3. Write the code.
4. Make sure all tests pass.
5. Commit with detailed explanation what you've done in a message.
6. Open pull request.

## Breaking/removing a feature

1. Add deprecation warning and fallback to old behaivour if possible.
2. Explain how to migrate to the new code in CHANGELOG.
3. Update/remove tests.
4. Update the code.
5. Make sure all tests pass.
6. Commit with detailed explanation what you've done in a message.
7. Open pull request.

## Fixing a bug

1. Add failing test.
2. Fix the bug.
3. Make sure all tests pass.
4. Commit with detailed explanation what you've done in a message.
5. Open pull request.

## Fixing a typo

1. Commit with a message that include "[ci skip]" remark.
2. Open pull request.

## Running the tests

```
bundle exec rake bundle
bundle exec rake test_all
```

## Working with documentation

```
yard server -dr
open http://localhost:8808
```

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
torba-rails-1.0.1	CONTRIBUTING.md
torba-rails-1.0.0	CONTRIBUTING.md