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