Commit cbf2bec3 authored by juliusv's avatar juliusv

Merge pull request #26 from prometheus/stability

Add FAQ section on stability guarantees.
parents 7dcef5fb 16d9f7f6
......@@ -30,6 +30,17 @@ The Alertmanager cannot currently be made highly available, but this is a goal.
Most Prometheus components are written in Go. Some are also written in Java and Ruby.
### How stable are Prometheus features, storage formats, and APIs?
Although Prometheus and many of its ecosystem components are already quite
stable, we will still allow for occasional breaking changes until the
Prometheus server reaches version 1.0.0. These breaking changes will be pointed
out in release announcements for components that already have a proper release
process (like the Prometheus server) or communicated clearly otherwise. After
releasing version 1.0.0, breaking changes will be indicated by increments of
the major version. See also the documentation for [semantic
versioning](http://semver.org/), which we are following.
### Why do you pull rather than push?
Pulling over HTTP offers a number of advantages:
......@@ -141,4 +152,4 @@ should take less than a minute under normal circumstances. See [crash recovery](
### I am using ZFS on Linux, and the unit test `TestPersistLoadDropChunks` fails. If I run Prometheus despite the failing test, the weirdest things happen.
You have run into a bug of ZFS on Linux. See [issue #484](https://github.com/prometheus/prometheus/issues/484)
for details. Upgrading to ZFS on Linux v0.6.4 should fix the issue.
\ No newline at end of file
for details. Upgrading to ZFS on Linux v0.6.4 should fix the issue.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment