One thing I forgot to mention: it'd be nice to have Marginalia support, 
since it can be used not only for annotated source code, but also for 
documentation with embedded tests (although, two-column layout doesn't fit 
very well for this purpose, but it's another question). 
 

> That's true. The github wiki's could be used for example code too. 
>
Though, I don't see it used much for that. Perhaps a dedicated site 
> like the alcove would encourage more contributions of example code?
>

Sure, if every visitor would see a big red button titled "Add an example!" 
there'd be much more chances that some examples will be contributed :)

Also, I think there's something to be said for having all the examples 
> in one place --- one repo that anyone can grab and have the full 
> collection. (Though, perhaps clojuredocs.org could support that too.) 
>

For me personally it doesn't matter; maybe someone else would find it 
useful.
 

> If clojuredocs.org were to be extended to support adding 3rd-party 
> projects, would users prefer to put example code there, or in the 
> project's github wiki?
>

I think authors who prefer github's wiki would rather continue use it, but 
the important thing that anybody interested would have the right place to 
add snippets, comments, etc.

Honestly, what I'd really appreciate is a full-blown community site, kind 
of mix between clojure-toolbox, clojuredocs and emacswiki.

-- 
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