Sha256: 5c5d831b6483f5fb9761b99e0423918808507dace7bee82a6354eff82f9c9e35

Contents?: true

Size: 1.59 KB

Versions: 14

Compression:

Stored size: 1.59 KB

Contents

# Contributing

## Workflow

We are using the [Feature Branch Workflow (also known as GitHub Flow)](https://guides.github.com/introduction/flow/), and prefer delivery as pull requests.

Our first line of defense is the [Travis CI](https://travis-ci.org/doorkeeper-gem/doorkeeper-openid_connect) build defined within [.travis.yml](.travis.yml) and triggered for every pull request.

Create a feature branch:

```sh
git checkout -B feature/contributing
```

## Creating Good Commits

The cardinal rule for creating good commits is to ensure there is only one
"logical change" per commit. Why is this an important rule?

* The smaller the amount of code being changed, the quicker & easier it is to
  review & identify potential flaws.

* If a change is found to be flawed later, it may be necessary to revert the
  broken commit. This is much easier to do if there are not other unrelated
  code changes entangled with the original commit.

* When troubleshooting problems using Git's bisect capability, small well
  defined changes will aid in isolating exactly where the code problem was
  introduced.

* When browsing history using Git annotate/blame, small well defined changes
  also aid in isolating exactly where & why a piece of code came from.

Things to avoid when creating commits:

* Mixing whitespace changes with functional code changes.
* Mixing two unrelated functional changes.
* Sending large new features in a single giant commit.

## Release process

- Bump version in `lib/doorkeeper/openid_connect/version.rb`
- Update `CHANGELOG.md`
- Commit all changes
- Tag release and publish gem with `rake release`

Version data entries

14 entries across 14 versions & 1 rubygems

Version Path
doorkeeper-openid_connect-1.7.1 CONTRIBUTING.md
doorkeeper-openid_connect-1.7.0 CONTRIBUTING.md
doorkeeper-openid_connect-1.6.3 CONTRIBUTING.md
doorkeeper-openid_connect-1.6.2 CONTRIBUTING.md
doorkeeper-openid_connect-1.6.1 CONTRIBUTING.md
doorkeeper-openid_connect-1.6.0 CONTRIBUTING.md
doorkeeper-openid_connect-1.5.5 CONTRIBUTING.md
doorkeeper-openid_connect-1.5.4 CONTRIBUTING.md
doorkeeper-openid_connect-1.5.3 CONTRIBUTING.md
doorkeeper-openid_connect-1.5.2 CONTRIBUTING.md
doorkeeper-openid_connect-1.5.1 CONTRIBUTING.md
doorkeeper-openid_connect-1.5.0 CONTRIBUTING.md
doorkeeper-openid_connect-1.4.0 CONTRIBUTING.md
doorkeeper-openid_connect-1.3.0 CONTRIBUTING.md