Looks great! Especially I like the clean design.
I'm waiting for DevDocs.io support for Clojure thought because there's nothing better than all docs in one place.
Clojure Grimoire: an up-to-date ClojureDocs alternative
11–20 of 23 posts
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#12Fantastic, also has much better examples than clojuredocs.org!
Author here: It's funny that you say this because as of right now there is only one example on Grimoire that isn't on Clojuredocs :P
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#13Cool. 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...
Author here. I'm definitely aware that there are many pitfalls to Clojure than just the standard library docs. There's an open issue for adding a syntax guide and a macro guide, I'd be delighted to add a destructuring guide.
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#14Cool. 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...
Author here. I'm definitely aware that there are many pitfalls to Clojure than just the standard library docs. There's an open issue for adding a syntax guide and a macro guide, I'd be delighted to add a destructuring guide.
Great! Do you think my example code (linked above) would be a good fit? It is mostly example-based.
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#15[deleted]
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#16This 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/…
For reference, the Clojure rewrite is https://github.com/zk/clojuredocs and is hosted at http://clojuredocs.herokuapp.com/
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#17This 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/…
I'd love to help with building a backend, if the author or someone else decides to go that way. Just recently finished rewriting my blog in Clojure, complete with csrf protection, db, sessions, and a bunch of shinies as well.
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#18Fantastic, also has much better examples than clojuredocs.org!
Author here: It's funny that you say this because as of right now there is only one example on Grimoire that isn't on Clojuredocs :P
Haha, that's surprising. Maybe the better presentation makes the examples look more plentiful.
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#19This 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/…
Author here. After maintaining a blog built around a "real" CMS, and a "real" CMS that I built myself, I'll say that my existing blog is built atop Jekyll and Git, the same stack I chose for Grimoire. It's simply the most basic thing that could possibly work, and it doesn't demand that I run a JVM on my inexpensive DigitalOcean instance. For all that I enjoy using Clojure, a "real" Ring server with a "real" database backend simply doesn't add anything to this project beyond complicating it further. As such I don't expect that a database rewrite of Grimoire is on the cards for some time to come.
To "how you build such a site in Clojure" the answer is that the entire Clojure ecosystem shies away from monolithic web frameworks and prepackaged solutions ala rails. Instead, Clojure libraries tend to pick a single feature or some small set of fetures, cover them well, expose a simple API and make composition trivial rather than trying to solve all possible problems.
Dash integration... Dash only makese sense for languages for which the documentation isn't trivially introspected such as Java. Clojure has the clojure.repl library (http://grimoire.arrdem.com/1.6.0/clojure.repl/) which is designed to solve this problem by exposing Clojure documentation to users in their interactive development (REPL) sessions. As I explain at some length in the Grimoire announcement post (http://arrdem.com/2014/07/12/of_mages_and_grimoires/) Grimoire seeks to fill a fumdimentally different niche than Dash. Clojure already has docs, and those docs are already handy for users aware of clojure.repl. Grimoire seeks to solve the problem of documenting the various ins and outs of the standard library which do _not_ appear in the official Clojure docs and which are currently spread out across any number of other low PageRank score community sites.
Re: Clojure Grimoire: an up-to-date ClojureDocs alternative
#20Author here. Holy cow. Thanks for all the kind words guys! I'm primarily a back end dev interested in hardware, compilers and operating systems. As a long time HN reader I can't begin to express how amazing it is that a my first "real" web service which I started less than a week ago made the front page.
I hope that for those Clojure users among you Grimoire proves a useful resource and I welcome any feedback or other commentary you may have on the site and its usability. Stay tuned, there's plenty more in the works from me and I'm reading the feedback with interest.