On Fri, Mar 23, 2012 at 4:49 PM, Andy Fingerhut <andy.finger...@gmail.com> wrote: > I'm not putting the Declaration of Independence in the tooltips, but the > Clojure doc strings, with the same text width as they appear in the original, > which is nearly 80 characters wide.
I'd suggest not using the full docstring, but something like the first sentence or so of the docstring, or even a briefer paraphrase. For example, for disj, map, and for, respectively, I'd suggest something like: Returns a copy of a set that does not contain specified keys. Iterates over a coll, or several colls in tandem, collecting the results of applying a fn. General sequence comprehensions (macro). The main purpose is to let someone quickly gauge whether the link they're hovering over is for the thing they're looking for. So it suffices for the description to either jog their memory, if they've seen it before, and give a quick precis of what it does or is used for regardless. The tooltip text doesn't need to be the full documentation; just enough information to guide a decision whether to click through to the full documentation or not. -- 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
