Skip to content

Latest commit

 

History

History
68 lines (42 loc) · 1.36 KB

CONTRIBUTING.md

File metadata and controls

68 lines (42 loc) · 1.36 KB

Contributing to DNSimple/Ruby

Getting started

1. Clone the repository

Clone the repository and move into it:

git clone git@github.com:dnsimple/dnsimple-ruby.git
cd dnsimple-ruby

2. Install the dependencies

Install the dependencies using Bundler:

bundle

3. Build and test

Run the test suite to check everything works as expected.

Releasing

The following instructions uses $VERSION as a placeholder, where $VERSION is a MAJOR.MINOR.BUGFIX release such as 1.2.0.

  1. Set the version in version.rb:

    VERSION = "$VERSION"
  2. Run the test suite and ensure all the tests pass.

  3. Finalize the ## main section in CHANGELOG.md assigning the version.

  4. Commit and push the changes

    git commit -a -m "Release $VERSION"
    git push origin main
  5. Wait for CI to complete.

  6. Create a signed tag.

    git tag -a v$VERSION -s -m "Release $VERSION"
    git push origin --tags

Testing

To run the test suite:

rake

Tests

Submit unit tests for your changes. You can test your changes on your machine by running the test suite.

When you submit a PR, tests will also be run on the continuous integration environment via GitHub Actions.