cljs-experience

https://docs.google.com/document/d/1vom_MUTmQjsmjeQgw60ChGO9NDD9AvoIwJPPzrf8FKM/edit#heading=h.657ovwb1zxit
mikeb 2017-05-24T21:19:05.205844Z

What can we do to build a cohesive and non-fractured set of documentation, tools and libraries that is welcoming to newcomers?

yogthos 2017-05-24T23:13:30.486801Z

I guess a good start might be to identify another language that we think does this well and emulate that

yogthos 2017-05-24T23:14:26.494303Z

another thing to do might be to run a community survey to see what are the top pain points and focus on those

yogthos 2017-05-24T23:16:40.513434Z

it would probably also be good to aggregate some of the existing docs such as http://himera.herokuapp.com/synonym.html

yogthos 2017-05-24T23:20:30.545161Z

probably would be good to reach out to Zachary Kim https://github.com/zk who runs http://clojuredocs.org as well

yogthos 2017-05-24T23:21:20.552232Z

I really like http://clojuredocs.org approach for API docs, having usage examples is extremely helpful

mikeb 2017-05-24T23:23:05.567128Z

Completely agree with clojuredocs, it's still the best source of reference.

mikeb 2017-05-24T23:24:36.579582Z

Existing community survey is good, but by asking existing community we will not hear from those who have tried and failed and those that might want to try, but that aren't part of the community per se.

mikeb 2017-05-24T23:25:39.588417Z

I'm thinking a post in /r/javascript asking about cljs might elicit some feedback.