diff --git a/src/docbkx/configuration.xml b/src/docbkx/configuration.xml
index de338e39015..8eafcdad276 100644
--- a/src/docbkx/configuration.xml
+++ b/src/docbkx/configuration.xml
@@ -128,6 +128,13 @@ to ensure well-formedness of your document after an edit session.
intricacies. Later when they've built some confidence, then they can play
with configuration such as this.
+
+ Number of ZooKeeper Instances
+ It is best to use an odd number of machines (1, 3, 5) for a ZooKeeper ensemble.
+ See the ZooKeeper Wiki or the
+ ZooKeeper documentation
+ for more information on ZooKeeper sizing.
+ hbase.regionserver.handler.count