Who's reading the documentation? Why not a simple comment?

Ambrose

On Tue, Jul 3, 2012 at 7:16 PM, skuro <carlo.scio...@gmail.com> wrote:

> Hi *,
>
> I'm developing a Clojure bridge to the Alfresco APIs, where I use a
> protocol, Node, to extend a class coming from the original Java API
> (NodeRef). Now, one of the project contributors proposed to add type hints
> to the return values of the Clojure API functions, so to have, e.g.:
>
> (defn ^Node user-home [..] ..)
>
>
> The sole declared purpose of it would be to document the user-home
> function to return a class that fulfills the Node protocol, not caring
> about reflection at all.
> Now, while there's a little voice from the back of my head that tells me
> it's not quite an idiomatic approach to the problem, I've not really any
> strong counter argument to it. Would you consider such strategy
> good/bad/great/harmful? Is it used already by any other project out there?
>
> Thanks,
> c.
>
> --
> 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 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