- Fork the project.
- Setup it on your machine with
bin/setup
. - Make sure the tests pass:
bin/ci
. - Make your change. Add tests for your change when necessary. Make the tests pass:
bin/ci
. - Mention your changes in "Unreleased" section of
CHANGELOG.md
- Push to your fork and submit a pull request (bonus points for topic branches).
We release new versions of Rails Base fortnightly on Fridays.
We do not strictly follow Semantic Versioning as we use only MAJOR
/MINOR
increments:
- Increment the
MAJOR
version when you make incompatible API changes. For example, upgrading Rails from 3.x to 4.x. - Increment the
MINOR
version when you make any other changes. That includes backwards-compatible changes and bug fixes.
When ready to release:
- Make sure that tests are green.
- Update the changelog with the new version and commit it with message "release ".
- Tag the release by running
git tag v<version>
. Push the tag:git push --tags
. - Verify that everything was pushed correctly on the Github: https://github.com/fs/rails-base/releases