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. 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 <rmckenzi...@gmail.com > <mailto:rmckenzi...@gmail.com>> 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 >> <http://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 clojure@googlegroups.com >> <mailto: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 >> <mailto: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 >> <mailto: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 > <mailto: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 > <mailto:clojure%2bunsubscr...@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 > <mailto:clojure+unsubscr...@googlegroups.com>. > For more options, visit https://groups.google.com/d/optout. > > > > > -- > E: mark.man...@gmail.com <mailto:mark.man...@gmail.com> > T: http://www.twitter.com/neurotic > W: www.compoundtheory.com <http://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 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 > <mailto: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.
