Skip to content

Latest commit

 

History

History
71 lines (53 loc) · 2.92 KB

CONTRIBUTING.md

File metadata and controls

71 lines (53 loc) · 2.92 KB
Raw


General Guidance

You can contribute to this project in the following ways:

  • Try out the master branch and provide feedback
  • File a bug report or propose a feature
  • Open a PR for bug fixes or implement requested features
  • Give feedback to opened issues/pull requests
  • Contribute documentation in the sentry-doc repo

And if you have any questions, please feel free to reach out on Discord.

Contribute To Individual Gems

  • Install the dependencies of a specific gem by running bundle in it's subdirectory. I.e: 
    cd sentry-sidekiq
bundle install
  • Install any additional dependencies. sentry-sidekiq assumes you have redis running.
  • Use bundle exec rake to run tests.
    • In sentry-rails, you can use RAILS_VERSION=version to specify the Rails version to test against. Default is 7.0
    • In sentry-sidekiq, you can use SIDEKIQ_VERSION=version to specify what version of Sidekiq to install when you run bundle install. Default is 7.0
  • Use example apps under the example or examples folder to test the change. (Remember to change the DSN first)
  • To learn more about sentry-ruby's structure, you can read the Sentry SDK spec

Write Your Sentry Extension

Please read the extension guideline to learn more. Feel free to open an issue if you find anything missing.

Release SDK Gem

Before the Release

  1. Run the example app(s) of the gem and make sure all the events are reported successfully.
  2. Update the changelog's latest Unreleased title with the target version.

Minor-version releases

  • Make sure all the new features are documented properly in the changelog. This includes but not limited to:
    • Explanation of the feature.
    • Sample code for the feature.
    • Expected changes on the SDK's behavior and/or on the reported events.
    • Some related screenshots.
  • Prepare a PR in the sentry-doc repo to update relevant content depending on the changes in the new release.

Major-version releases

In addition to all the steps listed above, you also need to:

  • Write a migration guide to
    • Outline the major changes done in this release.
    • Explain why upgrading is beneficial.
    • List all the breaking changes and help users make related changes in their apps.
  • Update gem READMEs.
  • May need to check related wizard files in the sentry-doc repo.