Reid, Thanks for the explanation - I did not realize the differences. I've been landing on clojuredocs primarily due to page rank but will be sure to include/check grimoire because I want/need the enhanced doc strings.
Terseness is great when you are an expert but I'm not there yet and can still use the extra help with some of the less frequently used functions. Thanks for your efforts putting grimoire together, much appreciated. Alan -- *"Whatever you can do, or dream you can do, begin it. Boldness has genius, power, and magic in it. Begin it now."* - *Goethe* On Jan 19, 2016, at 11:54 AM, Reid McKenzie <rmckenzi...@gmail.com> wrote: Grimoire was originally built to replace ClojureDocs when it had been inactive for some time, and as it turns out mere months prior to the big update which is now live. That I continue to operate Grimoire now that ClojureDocs has been updated is I suppose competition at some level. Yes ClojureDocs and Grimoire use independent and unsynchronized content stores. Originally Grimoire started with all of ClojureDocs' examples unaltered. I put a bunch of time into reformatting and editing them for Grimoire this summer. I've shared these changes with zkim although I don't think he's done anything with them yet. As to documentation, ClojureDocs serves the default unmodified Clojure docstrings. My goal with Grimoire is to largely replace these famously curt strings with more fully formed articles and commentary. This is very much a demand directed operation, with the worklist [1] or personal points of friction being used to direct priorities. The examples on both ClojureDocs and Grimoire are adequate. I don't think there's value being lost between one or the other there. ClojureDocs has a huge Google PageRank lead which I don't think it's worthwhile to invest time competing against. Hence my goal has been to provide augmented docstrings which are I hope more helpful. Reid [1] conj.io/worklist On 01/18/2016 09:31 PM, Mars0i wrote: Thanks Reid. I'm a little confused about the relationships between the goals of ClojureDocs and Grimoire. They both provide community-supported documentation. The top-level interfaces are different of course, but I'm not sure whether there are differences in functionality once one knows the ins and outs of each system. (I see now that some of what I thought was available only in ClojureDocs is available on Grimoire as well.) Are ClojureDocs and Grimoire in competition? If so, there's nothing necessarily wrong with that; each person can choose what seems best. Perhaps there is this drawback: If a user adds an example or comment to one, it won't appear in the other. Given that the core documentation in each is the same, one would have to scan through two pages for a single function in order to see whether there's any useful information in one but not the other. -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to a topic in the Google Groups "Clojure" group. To unsubscribe from this topic, visit https://groups.google.com/d/topic/clojure/Qn55soAb5zQ/unsubscribe. To unsubscribe from this group and all its topics, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
