On Tuesday, July 8, 2014 3:07:03 PM UTC-4, Reid McKenzie wrote: > > 1) doesn't make a whole lot of sense. I'm an adherent to the "simplest > thing that could possibly work" philosophy, and as a result Grimoire is > entirely static HTML. Search and symbol quick access could be implemented > by adding some javascript, but that's a low priority item at the moment as > there are still basic usability and layout concerns being addressed. Feel > free to open an improvement issue on Github ( > http://github.com/arrdem/grimoire/). Down the road it may be worth > questioning this static HTML approach as there are a number of tricks one > could play such as ranking symbols by the frequency with which their > documentation is visited which are impossible in pure static HTML. > > 2) this probably does make sense. I think it's worth doing some more > general study of how people discover Clojure functions, but the categorized > quick reference provided by the various cheat sheets is an index I'd love > to have in Grimoire, perhaps even as part of the homepage? > > 3) http://grimoire.arrdem.com/ exists, however it's pretty broken and > there's some configuration changes that need to happen (and which will > break http://arrdem.com/grimoire) in order for it to work. I'm open for > suggestions WRT having a dedicated domain, however remember I'm a GSoC > student on a shoestring budget building this in my free time :P. I'm open > to comment as to which URL you find more generally useful. >
I'd also love to see a custom domain for this as well. I'm happy to pay for it if no one else will. How about clj-docs.org or clj-doc.org (which are available)? I do see clojuredoc.org is available but could easily be confused with clojuredocs.org. > Reid > > On 07/07/2014 11:49 PM, Mark Mandel wrote: > > Nice work! I've been using Grimoire all day :) > > Two small suggestions, which you have probably thought of: (1) search > (2) a copy of the clojure cheat sheet that points to grimoire instead. > (Maybe Grimoire needs it's own domain?) > > CrossClj is *awesome* as well. I've been wanting something similar for a > looong time. Thanks! > > Mark > > > > On Tue, Jul 8, 2014 at 2:31 PM, Reid McKenzie <rmcke...@gmail.com > <javascript:>> wrote: > >> I'm delighted to announce that thanks to the official Clojuredocs client >> (https://github.com/dakrone/clojuredocs-client) Grimoire now features >> every example posted on Clojuredocs. >> >> Ex. >> http://www.arrdem.com/grimoire/1.6.0/clojure.core/DASH__GT__GT/#example-0 >> >> Currently at 0.0.13, which represents a slew of changes since the >> original announcement including the dropping of 1.5.1 as a documented >> version (it's a patch release, nothing changed from 1.5.0) and a major >> rework of the way I munge symbols and include examples between versions. >> >> I'd like to give Alex (puredanger) a huge shout out for handing me a SQL >> dump of the clojuredocs examples table right after I got a dakrone's client >> working. >> >> More tooling thanks to Phil (technomancy), lein's profiles enabled me to >> ditch a make target which downloaded old Clojure versions in favor of >> simply having one lein profile for each documented Clojure version. >> >> >> Reid >> >> On 07/07/2014 04:54 PM, cldwalker wrote: >> >> Hey Reid, >> >> Nice work! I think this is a much more maintainable approach for a >> community-based examples repository. Have you thought about seeding >> examples from clojuredocs using their api e.g. >> http://api.clojuredocs.org/examples/1.3.0/clojure.core/map? I think this >> would help if the goal is to become the canonical site for clojure fn >> examples. >> >> It is worth noting that clojuredocs is undergoing a rewrite, >> https://github.com/zk/clojuredocs/tree/clj-rewrite. If this rewrite >> lands soon than it may be worth adding a Motivation section to the home >> page to distinguish it from clojuredocs.org. >> >> On Tuesday, July 1, 2014 7:34:38 PM UTC-4, Reid McKenzie wrote: >>> >>> Hey guys, >>> >>> If you're like me while using clojure.repl/doc works for the most part >>> there are just times that you need to send someone a link to the >>> official docs and navigating the docstrings in the core Clojure >>> repository is a pain. >>> >>> After several months of being frustrated that clojuredocs is out of >>> date, I finally sat down and built an alternative which I'm pleased to >>> present here: http://www.arrdem.com/grimoire/ >>> >>> Grimoire is still alpha and subject to change, especially with regards >>> to the example contribution process which needs streamlining beyond the >>> current "click a link, edit on github and submit a PR". >>> >> >> I think this is a reasonable approach. It's better than having a login >> just for clojuredocs. >> >> >>> >>> I'd like to give a shout out to César for porting clojure.repl/source >>> into the doc generation script and to Nicola for his random usability >>> criticisms. >>> >> >> >> >> Cheers, >> Gabriel >> >> >>> >>> Reid McKenzie >>> >> -- >> You received this message because you are subscribed to the Google >> Groups "Clojure" group. >> To post to this group, send email to clo...@googlegroups.com >> <javascript:> >> Note that posts from new members are moderated - please be patient with >> your first post. >> To unsubscribe from this group, send email to >> clojure+u...@googlegroups.com <javascript:> >> 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+u...@googlegroups.com <javascript:>. >> 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 clo...@googlegroups.com >> <javascript:> >> Note that posts from new members are moderated - please be patient with >> your first post. >> To unsubscribe from this group, send email to >> clojure+u...@googlegroups.com <javascript:> >> 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+u...@googlegroups.com <javascript:>. >> For more options, visit https://groups.google.com/d/optout. >> > > > > -- > E: mark....@gmail.com <javascript:> > T: http://www.twitter.com/neurotic > W: www.compoundtheory.com > > 2 Devs from Down Under Podcast > http://www.2ddu.com/ > -- > You received this message because you are subscribed to the Google > Groups "Clojure" group. > To post to this group, send email to clo...@googlegroups.com <javascript:> > Note that posts from new members are moderated - please be patient with > your first post. > To unsubscribe from this group, send email to > clojure+u...@googlegroups.com <javascript:> > 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+u...@googlegroups.com <javascript:>. > 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.
