Fork me on GitHub
#docs
<
2015-06-11
>
arrdem00:06:22

https://github.com/clojure-grimoire/datastore/pull/5 Finally finished that big refactor of the Clojure examples...

arrdem00:06:23

next on deck is finishing the flowing cheatsheet, and then ripping off the http://cljs.info style for individual documentation pages šŸ˜›

danielcompton01:06:36

Reformat for style Reformat for style Reformat for style Reformat for style Reformat for style Reformat for style Reformat for style Reformat for style Reformat for style …. Reformat for style

arrdem01:06:50

911 commits of style fixes

arrdem01:06:00

and a couple duplicate/bad examples that got deleted

danielcompton02:06:16

I find it really frustrating that most Clojure libraries assume that docstrings are appropriate documentation

arrdem15:06:45

No they really aren't

aaronm15:06:45

appropriate but not sufficient

arrdem17:06:45

The really hard part is writing and publishing discoverable usage examples...

arrdem17:06:04

I really like what the Python docs do in that you have long format article/API documentation with small inline examples

arrdem17:06:17

and working common case programs at the bottom