I use clojuredocs daily and would definitely benefit from it being as 
up-to-date as possible. I wasn't even aware of those two macros you listed, 
which is a bummer and a good indication that a replacement might be 
warranted.

I'd be happy to use your wiki as a day-to-day reference, or we can somehow 
keep ClojureDocs more up to date, although I'm not sure who's running it.

On Sunday, September 8, 2013 1:07:33 AM UTC-7, Steven Degutis wrote:
>
> ClojureDocs.org is pretty awesome, I think I use it nearly every day, 
> especially for the Examples and See Also sections. But sometimes I've 
> been wishing it had Clojure 1.5.1 support. For example, I think as-> 
> and cond-> would have been easier for me to pick up had there been 
> entries for these with community-driven Examples. 
>
> A while back, someone told me "complaining is laziness". So I worked 
> on an experiment that I'd like to propose to you all. It's a github 
> wiki that's been seeded with data scraped from in-process docs and 
> clojuredocs.org's API. Here it is: 
>
> https://github.com/sdegutis/clojuredocs/wiki 
>
> Pros: 
> - Docs are for Clojure 1.5.1 
> - Anyone logged into github can edit it 
> - Any part of it can be edited (to fix typos in docstring, etc) 
> - All namespaces are shown on the Home page for easy searching 
> - Free hosting, free database storage :) 
>
> Cons: 
> - Doesn't have dynamic relevance-based search field 
> - Doesn't have an API (but an external one could be built) 
> - Doesn't have Quick Ref tables (yet) 
> - A few URLs are kind of ugly 
> - The namespace-navigation bar is gone, you'd have to click Home 
> - Doesn't store nearly as much data as clojuredocs.org does 
>
> (But as usual, pros/cons are totally subjective to individual needs. 
> This is just how I saw it. These tables may be reversed for you, who 
> knows.) 
>
> Right now, it only has core namespaces. But I've made it easy to add 
> data from new namespaces, so long as the right dependencies are added 
> to project.clj. 
>
> Thoughts? 
>
> -Steven 
>

-- 
-- 
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 unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to