This is an automated email from the ASF dual-hosted git repository.
hanm pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/zookeeper.git
The following commit(s) were added to refs/heads/master by this push:
new f252c76 ZOOKEEPER-3373: need change description for "Single System
Image" guarantee in document
f252c76 is described below
commit f252c769206a9ed9688998a1608bcbd2840a90f4
Author: 数组越界 <ihavenoem...@163.com>
AuthorDate: Mon Aug 5 16:51:41 2019 -0700
ZOOKEEPER-3373: need change description for "Single System Image" guarantee
in document
In website, "Single System Image" is "A client will see the same view of
the service regardless of the server that it connects to."
I want to change it to "Once connected, a client will see the same view of
the service even if it switchs to another server"
Because the old one is a little misleading, if cluster has a outdated
follower and a normal follower, I do not think a client will see the same view
of the service regardless of the server that it connects to at its first
connection.
Author: 数组越界 <ihavenoem...@163.com>
Reviewers: maoling <maoling199210...@sina.com>, Andor Molnár
<an...@apache.org>, Michael Han <h...@apache.org>
Closes #931 from kabike/ZOOKEEPER-3373
---
zookeeper-docs/src/main/resources/markdown/zookeeperOver.md | 4 +++-
zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md | 4 +++-
2 files changed, 6 insertions(+), 2 deletions(-)
diff --git a/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
b/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
index 6ea96cb..1c00609 100644
--- a/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
+++ b/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
@@ -159,7 +159,9 @@ synchronization, it provides a set of guarantees. These are:
* Atomicity - Updates either succeed or fail. No partial
results.
* Single System Image - A client will see the same view of the
- service regardless of the server that it connects to.
+ service regardless of the server that it connects to. i.e., a
+ client will never see an older view of the system even if the
+ client fails over to a different server with the same session.
* Reliability - Once an update has been applied, it will persist
from that time forward until a client overwrites the update.
* Timeliness - The clients view of the system is guaranteed to
diff --git a/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
b/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
index 0d3797a..e7577b4 100644
--- a/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
+++ b/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
@@ -1054,7 +1054,9 @@ guarantees:
* *Single System Image* :
A client will see the same view of the service regardless of
- the server that it connects to.
+ the server that it connects to. i.e., a client will never see an
+ older view of the system even if the client fails over to a
+ different server with the same session.
* *Reliability* :
Once an update has been applied, it will persist from that
