Skip to content

Commit

Permalink
Website: clean up docs/compatibility.
Browse files Browse the repository at this point in the history
  • Loading branch information
ryanbreen committed Feb 17, 2015
1 parent 802804a commit b7ba331
Showing 1 changed file with 14 additions and 14 deletions.
28 changes: 14 additions & 14 deletions website/source/docs/compatibility.html.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -3,29 +3,29 @@ layout: "docs"
page_title: "Consul Protocol Compatibility Promise"
sidebar_current: "docs-upgrading-compatibility"
description: |-
We expect Consul to run in large clusters as long-running agents. Because upgrading agents in this sort of environment relies heavily on protocol compatibility, this page makes it clear on our promise to keeping different Consul versions compatible with each other.
We expect Consul to run in large clusters of long-running agents. Because safely upgrading agents in this sort of environment relies heavily on backwards compatibility, we have a strong commitment to keeping different Consul versions protocol-compatible with each other.
---

# Protocol Compatibility Promise

We expect Consul to run in large clusters as long-running agents. Because
upgrading agents in this sort of environment relies heavily on protocol
compatibility, this page makes clear our promise to keep different Consul
versions compatible with each other.
We expect Consul to run in large clusters of long-running agents. Because
safely upgrading agents in this sort of environment relies heavily on backwards
compatibility, we have a strong commitment to keeping different Consul
versions protocol-compatible with each other.

We promise that every subsequent release of Consul will remain backwards
compatible with _at least_ one prior version. Concretely: version 0.5 can
speak to 0.4 (and vice versa), but may not be able to speak to 0.1.
speak to 0.4 (and vice versa) but may not be able to speak to 0.1.

The backwards compatibility is automatic unless otherwise noted. Consul agents by
default will speak the latest protocol, but can understand earlier
ones. If speaking an earlier protocol, _new features may not be available_.
The ability for an agent to speak an earlier protocol is so that they
can be upgraded without cluster disruption.
Backwards compatibility is automatic unless otherwise noted. Consul agents by
default will speak the latest protocol but can understand earlier ones. Note:
if speaking an earlier protocol, _new features may not be available_.

This compatibility guarantee makes it possible to upgrade Consul agents one
at a time, one version at a time. For more details on the specifics of
upgrading, see the [upgrading page](/docs/upgrading.html).
The ability for an agent to speak an earlier protocol is to ensure that any agent
can be upgraded without cluster disruption. Consul agents can be updated one
at a time, one version at a time.

For more details on the specifics of upgrading, see the [upgrading page](/docs/upgrading.html).

## Protocol Compatibility Table

Expand Down

0 comments on commit b7ba331

Please sign in to comment.