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