Re:ClojureScript 101
by michaelsbradley on Friday November 08, 2013 @11:16PM
(#6700661)
For example: I'm aware of 'js*', but where is it defined? Where is it documented? Does it have any "gotchas" that are explained somewhere?
Re:ClojureScript 101
by swannodette on Saturday November 09, 2013 @11:04AM
(#6701975)
js* should not be used - it's an implementation detail. I agree we could do a better job documenting what's unique to ClojureScript over Clojure.
The API Overview[1] page for Clojure itself is great, and many of those facilities are 1-to-1 in cljs. For individual libs, like core.async, it's easy enough to go look in the cljs namespaces (i.e. the source code) to see what's available.
But it seems there are at least several important facilities unique to ClojureScript and it would be great if they were spelled out somewhere readily accessible and linked to from the main README[2]. Digging through the source is a bit more challenging given that there's more to wade through than for individual libs.
[1] http://clojure.github.io/clojure/
[2] https://github.com/clojure/clojurescript/blob/master/README....