Reid, thanks very much for the explanation, and thanks for all of the work. Knowing that the docstrings may be different on Grimoire is very helpful.
On Tuesday, January 19, 2016 at 1:54:48 PM UTC-6, Reid McKenzie 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 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.
