Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

COMPATIBILITY.md #136

Merged
merged 1 commit into from
Jul 6, 2019
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions COMPATIBILITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Compatibility

We aim for the Prometheus Ruby client to be compatible with all supported
versions of Ruby, across the MRI and JRuby platforms.

Any Ruby version that has not received an End-of-Life notice (e.g.
[this notice for Ruby 2.1](https://www.ruby-lang.org/en/news/2017/04/01/support-of-ruby-2-1-has-ended/))
is supported.

To ensure we're meeting these guidelines, we test the client against all
supported versions, as specified in our [build matrix](.travis.yml).

# Deprecation

Whenever a version of Ruby falls out of support we will mirror that change in
the Prometheus Ruby client by updating the build matrix and releasing a new
major version.

At that point we will close any issues that affect only the unsupported version,
and may choose to remove any workarounds from the code that are only necessary
for the unsupported version.

The major version bump signals the break in compatibility. If the client happens
to work on unsupported versions of Ruby this is by chance, and we wouldn't
consider that version to be officially supported.