[ 
https://issues.apache.org/jira/browse/ZOOKEEPER-264?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12661803#action_12661803
 ] 

Patrick Hunt commented on ZOOKEEPER-264:
----------------------------------------

In general our docs for client state are lacking, might be good to beef up this 
section

http://hadoop.apache.org/zookeeper/docs/r3.0.1/zookeeperProgrammers.html#sc_connectingToZk

including the state transition diagram and also discussion of the states and 
their meaning. This is even more evident to me based on the numerous questions 
we've been getting of late on the user lists regarding this issue.

> docs should include a state transition diagram for client state
> ---------------------------------------------------------------
>
>                 Key: ZOOKEEPER-264
>                 URL: https://issues.apache.org/jira/browse/ZOOKEEPER-264
>             Project: Zookeeper
>          Issue Type: Improvement
>          Components: documentation
>    Affects Versions: 3.0.0, 3.0.1
>            Reporter: Patrick Hunt
>            Assignee: Flavio Paiva Junqueira
>            Priority: Minor
>             Fix For: 3.1.0
>
>
> we should have a state transition diagram to help users understand client 
> state transitions. perhaps the edges could indicate what might cause such a  
> transition? (not sure if that will work). keep in mind for the states that 
> the java/c clients have diff names for constants (not sure how to handle). 
> This should be added to the programmer guide in the appropriate section.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

Reply via email to