Skip to content
This repository has been archived by the owner on Nov 29, 2023. It is now read-only.

Latest commit

 

History

History
37 lines (25 loc) · 2.27 KB

CONTRIBUTING.md

File metadata and controls

37 lines (25 loc) · 2.27 KB
Raw

Contributing to Absolutely

There are a couple ways you can help improve Absolutely:

  1. Fix an existing issue and submit a pull request.
  2. Review open pull requests.
  3. Report a new issue. Only do this after you've made sure the behavior or problem you're observing isn't already documented in an open issue.

Getting Started

Absolutely is developed using Ruby 2.6.10 and is additionally tested against Ruby 2.7, 3.0, and 3.1 using GitHub Actions.

Before making changes to Absolutely, you'll want to install Ruby 2.6.10. It's recommended that you use a Ruby version managment tool like rbenv, chruby, or rvm. Once you've installed Ruby 2.6.10 using your method of choice, install the project's gems by running:

bundle install

Making Changes

  1. Fork and clone the project's repo.
  2. Install development dependencies as outlined above.
  3. Create a feature branch for the code changes you're looking to make: git checkout -b my-new-feature.
  4. Write some code!
  5. If your changes would benefit from testing, add the necessary tests and verify everything passes by running bundle exec rspec.
  6. Commit your changes: git commit -am 'Add some new feature or fix some issue'. (See this excellent article for tips on writing useful Git commit messages.)
  7. Push the branch to your fork: git push -u origin my-new-feature.
  8. Create a new pull request and we'll review your changes.

Code Style

Code formatting conventions are defined in the .editorconfig file which uses the EditorConfig syntax. There are plugins for a variety of editors that utilize the settings in the .editorconfig file. We recommended you install the EditorConfig plugin for your editor of choice.

Your bug fix or feature addition won't be rejected if it runs afoul of any (or all) of these guidelines, but following the guidelines will definitely make everyone's lives a little easier.