Skip to content

Latest commit

 

History

History
112 lines (73 loc) · 2.66 KB

RELEASING.md

File metadata and controls

112 lines (73 loc) · 2.66 KB

Releasing Grape

There're no particular rules about when to release Grape. Release bug fixes frequently, features not so frequently and breaking API changes rarely.

Release

Run tests, check that all tests succeed locally.

bundle install
rake

Double-check that the last build succeeded for all supported platforms.

Those with r/w permissions to the master Grape repository generally have large Grape-based projects. Point one to Grape HEAD and run all your API tests to catch any obvious regressions.

gem grape, github: 'ruby-grape/grape'

Modify the "Stable Release" section in README.md. Change the text to reflect that this is going to be the documentation for a stable release. Remove references to the previous release of Grape. Keep the file open, you'll have to undo this change after the release.

## Stable Release

You're reading the documentation for the stable release of Grape, 0.6.0.

Change "Next Release" in CHANGELOG.md to the new version.

#### 0.6.0 (2013/9/16)

Remove the line with "Your contribution here.", since there will be no more contributions to this release.

Commit your changes.

git add README.md CHANGELOG.md
git commit -m "Preparing for release, 0.6.0."
git push origin master

Release.

$ rake release

grape 0.6.0 built to pkg/grape-0.6.0.gem.
Tagged v0.6.0.
Pushed git commits and tags.
Pushed grape 0.6.0 to rubygems.org.

Prepare for the Next Version

Modify the "Stable Release" section in README.md. Change the text to reflect that this is going to be the next release.

## Stable Release

You're reading the documentation for the next release of Grape, which should be 0.6.1.
The current stable release is [0.6.0](https://github.com/ruby-grape/grape/blob/v0.6.0/README.md).

Add the next release to CHANGELOG.md.

### 0.6.1 (Next)

#### Features

* Your contribution here.

#### Fixes

* Your contribution here.

Bump the minor version in lib/grape/version.rb.

module Grape
  VERSION = '0.6.1'.freeze
end

Commit your changes.

git add CHANGELOG.md README.md lib/grape/version.rb
git commit -m "Preparing for next development iteration, 0.6.1."
git push origin master

Make an Announcement

Make an announcement on the ruby-grape@googlegroups.com mailing list. The general format is as follows.

Grape 0.6.0 has been released.

There were 8 contributors to this release, not counting documentation.

Please note the breaking API change in ...

[copy/paste CHANGELOG here]