I agree. The in-code function documentation serves its purpose but could be improved upon in a medium where space is at less of a premium.
Bill Smith Austin, TX On Jul 10, 12:36 pm, James Reeves <jree...@weavejester.com> wrote: > On 10 July 2010 15:06, Stuart Halloway <stuart.hallo...@gmail.com> wrote: > > > (6) Because docstrings are designed for consumption at a REPL, they may in > > some cases presume a fixed font. Worth considering for display on the site. > > What about giving function documentation the same "wiki" behaviour > that the examples have? Start off with the docstrings as the initial > values, but allow people to update them. The web allows longer and > better formatted documentation than a standard Clojure docstring > (which needs to fit in a terminal). > > - James -- 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
