Clojure Grimoire: an up-to-date ClojureDocs alternative

Neat. Apart from the bright red color of the search field, it's great! I just started playing around a little with Clojure and having the docs right at your fingertips definitely helps.

Re: Clojure Grimoire: an up-to-date ClojureDocs alternative

#5

Post by Terretta » Sun, Jul 13, 2014, 1:34 PM UTC

I've been using Clojure Cheatsheets from Andy Fingerhut at http://jafingerhut.github.io and particularly happy with the color PDF versions (link below).

Andy actively keeps up with issues and pulls to make sure the output stays well formatted for easy printing on both US Letter and A4 as well as of course an HTML online reference.

His cheatsheets traditionally linked to ClojureDocs, but just yesterday Andy accepted a pull request to merge in targeting Grimoire, while Reid mashed up Andy's work into the Grimoire homepage:

    arrdem commented 2 days ago
    Thank you. I'm working on mashing the Grimoire linked version up to be
    part of 0.2.0's homepage :D
    …

    On 07/11/2014 02:52 PM, Andy Fingerhut wrote:

     Thanks! I'll try generating HTML and PDF cheat sheets with these
     changes, and if everything goes well I will publish Grimoire-linked
     HTML versions at http://jafingerhut.github.io and announce on the
     Google group.

-- https://github.com/jafingerhut/clojure-cheatsheets/pull/10

I appreciate clojure community collaboration and it's great these two projects sync'd up:

http://jafingerhut.github.io - various versions of cheetsheet

http://grimoire.arrdem.com - cheatsheet + docs

Or go here for the PDFs:

https://github.com/jafingerhut/clojure-cheatsheets/tree/mast...

Re: Clojure Grimoire: an up-to-date ClojureDocs alternative

#6

Post by threeseed » Sun, Jul 13, 2014, 1:39 PM UTC

janerik wrote: post #4

Neat. Apart from the bright red color of the search field, it's great! I just started playing around a little with Clojure and having the docs right at your fingertips definitely helps.

Agreed. It should just change the text colour and there is also a bug where if the text field is blank it still shows as red. Otherwise brilliant site.

Re: Clojure Grimoire: an up-to-date ClojureDocs alternative

#7

Post by dj-wonk » Sun, Jul 13, 2014, 2:02 PM UTC

Cool. One limitation I've seen is a lack of destructuring examples. So, for those who get a little hung up with some of the more complicated destructuring permutations, I made a walkthrough here: https://github.com/xpe/clj-destruct/blob/master/src/destruct...

Re: Clojure Grimoire: an up-to-date ClojureDocs alternative

#8

Post by stevepike » Sun, Jul 13, 2014, 2:21 PM UTC

This is really awesome, thanks for building it. I was just working on a toy clojurescript project yesterday and while clojuredocs is very useful it's sad it hasn't been updated in forever. I've found examples to be incredibly helpful in composing functional-style code. For instance, compare assoc: http://clojure.github.io/clojure/clojure.core-api.html#cloju... and http://grimoire.arrdem.com/1.6.0/clojure.core/assoc/.

The architecture choice OP made is clever - a completely static page linking to github for the CMS part. Would you consider writing a server-backed version at some point in the future? Clojuredocs was originally written in rails and is being re-written in clojure, but that's going slowly. I would absolutely love to see a well-written clojure backend for this type of site as a reference. I've been really enjoying using clojure for standalone things, but I can't yet imagine how I'd build a web server with all the production features something like rails gives you ootb (asset compilation, csrf, sessions, db connections, orm, testing w. transaction-based fixtures, etc).

Now if I could just integrate this with dash (http://kapeli.com/dash)!

Re: Clojure Grimoire: an up-to-date ClojureDocs alternative

#9

Post by smrtinsert » Sun, Jul 13, 2014, 3:13 PM UTC

Ah, thank you. I get frustrated by clojuredocs out of dateness, but I do like their comments.

Re: Clojure Grimoire: an up-to-date ClojureDocs alternative

#10

Post by th0ma5 » Sun, Jul 13, 2014, 3:21 PM UTC

Have to use landscape in Chrome on Android. This is really really great!! I have a friend that knows C and wonders how the heck Clojure actually does anything. I've tried but anyone have any good links?