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

Reply via email to