improve docs

[oakmac]

The following docs have TODOs in them and need to be reviewed / improved.

# grep -Irl "TODO" .
./cljs.core_-GT.cljsdoc
./cljs.core_-GTGT.cljsdoc
./cljs.core_apply.cljsdoc
./cljs.core_as-GT.cljsdoc
./cljs.core_comp.cljsdoc
./cljs.core_def.cljsdoc
./cljs.core_doall.cljsdoc
./cljs.core_doseq.cljsdoc
./cljs.core_fn.cljsdoc
./cljs.core_for.cljsdoc
./cljs.core_identity.cljsdoc
./cljs.core_ns.cljsdoc
./cljs.core_partition.cljsdoc
./cljs.core_take-last.cljsdoc
./cljs.core_to-array-2d.cljsdoc
./cljs.core_when-first.cljsdoc

[oakmac]

Maybe @imalooney can assist?

[NPrescott]

Because manually navigating to those is hard: TODO in path:/docs

Do you have a designated location for the threading macro animation yet? Several issues call for a link but I don't know that there's a permanent home yet.

[NPrescott]

The more I think about it, as a community project (ostensibly) how is cljs.info addressing the overlap with projects like Grimoire - Clojure Documentation or even the Clojure Docs themselves? Each is Clojure specific (rather than Clojurescript) but contains many community contributed examples already. Should we just lift examples from there? Should we ask that people contribute to both places?

Specifically I'm looking at the apply docs calling for examples, when this already exists.

[oakmac]

My initial thinking was to copy the best examples that already exist (ie: clojuredocs, grimoire, etc) and then edit / curate.

I think the examples should be stored in simple text files similar to the cljsdoc files (maybe inside the existing cljsdoc files as a new section?)

The editing / curation part will be the most important.

[oakmac]

re: the threading macro animation links

The threading macro animations project is still a work in progress. I plan to update those docs when the site is ready.

[shaunlebron]

I'm going to close this issue here. Some points:

• We've talked with zachary from clojuredocs and reid from grimoire and we all agreed to use CC0 to license the examples, meaning we can all trade them.
• the following screenshot is taken from the docs view for cljs.core/apply, which has links to the respective entry in clojuredocs, grimoire, crossclj for example referencing, and the links at the bottom for editing and learning how to edit.