{"action":"closed","issue":{"url":"https://api.github.com/repos/paypal/downshift/issues/263","repository_url":"https://api.github.com/repos/paypal/downshift","labels_url":"https://api.github.com/repos/paypal/downshift/issues/263/labels{/name}","comments_url":"https://api.github.com/repos/paypal/downshift/issues/263/comments","events_url":"https://api.github.com/repos/paypal/downshift/issues/263/events","html_url":"https://github.com/paypal/downshift/issues/263","id":276419785,"number":263,"title":"Beginner friendly docs ","user":{"login":"kamir222","id":11549223,"avatar_url":"https://avatars2.githubusercontent.com/u/11549223?v=4","gravatar_id":"","url":"https://api.github.com/users/kamir222","html_url":"https://github.com/kamir222","followers_url":"https://api.github.com/users/kamir222/followers","following_url":"https://api.github.com/users/kamir222/following{/other_user}","gists_url":"https://api.github.com/users/kamir222/gists{/gist_id}","starred_url":"https://api.github.com/users/kamir222/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kamir222/subscriptions","organizations_url":"https://api.github.com/users/kamir222/orgs","repos_url":"https://api.github.com/users/kamir222/repos","events_url":"https://api.github.com/users/kamir222/events{/privacy}","received_events_url":"https://api.github.com/users/kamir222/received_events","type":"User","site_admin":false},"labels":[{"id":759336145,"url":"https://api.github.com/repos/paypal/downshift/labels/docs","name":"docs","color":"006b75","default":false},{"id":654664869,"url":"https://api.github.com/repos/paypal/downshift/labels/help%20wanted","name":"help wanted","color":"128A0C","default":true}],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":16,"created_at":"2017-11-23T15:53:53Z","updated_at":"2018-05-09T20:38:27Z","closed_at":"2018-05-09T20:38:26Z","author_association":"NONE","body":"I wanted to bring attention to something I’ve experienced when integrating this component into the app I’m building. I like this component a lot as it covers accessibility and gives me a lot of flexibility in styling and functionality. I’ve gone through a lot of autocompletes before I found this one, so thank you. \r\n\r\nBut perhaps a more beginner friendly documentation would be useful for people like me who are junior web developers that rely on these solutions. In particular, I couldn’t figure out when to use `onStateChange` and `onInputValueChange` properly because I kept thinking of uncontrolled components as those handled by the DOM that make use of refs, while controlled components as state based. It took time and my co-worker to point out that I was thinking about this in the wrong context. \r\n\r\n`onInputValueChange` can be elaborated on and the definition of “controlled” in this context can be more clear as it is done in the explanation of onStateChange. More on why they are different and how to use them.  \r\n\r\nMore examples explaining how to use some of the functions, such as `onOuterClick` and `getRootProps` could also help. \r\n\r\nWith that said, thanks for building this. There are a lot of advanced topics covered like render props vs HOC and I appreciate all the links that explain these topics. I’m learning a lot in the process. "}}
{"actor":{"display_login":"kentcdodds"}}