Github user anmolnar commented on the issue:
https://github.com/apache/zookeeper/pull/582
Thanks @eolivelli . It makes perfect sense to me now.
Adding more docs (especially javadoc in this case) is always a good idea.
Copying the above description to javadoc is sufficient I believe.
I'm happy to commit once you're ready and have a green build.---
