Re: Clojure application in the wild, to learn beautiful Clojure technique(s) from

2010-10-31 Thread zkim
Enlive (also Christophe Grand's) is definitely a project you'll want to check out: http://github.com/cgrand/enlive Pairing enlive with David Nolan's tutorial (http://github.com/ swannodette/enlive-tutorial/) allows you to consume the codebase in bite-sized pieces (read about a feature in the tutor

Re: Getting this error regarding duck-streams/spit ...

2010-10-30 Thread zkim
Looks like I'm a bit late to the party on this one. ClojureDocs, as Tom mentioned, dosen't currently track the :deprecated metadata entry, which will be fixed once clojuredocs is able to consume autodoc's output. Apologies for the confusion. -Zack On Oct 27, 12:57 am, Btsai wrote: > Awesome!  

ClojureDocs is in Beta

2010-10-20 Thread zkim
Hey All, ClojureDocs is now in beta, relevant info below. Site: http://clojuredocs.org Beta Info: http://clojuredocs.wordpress.com/2010/10/19/clojuredocs-beta/ Main Repo: http://github.com/zkim/clojuredocs Thanks, Zack. -- You received this message because you are subscribed to the Google

Re: Documentation tools

2010-09-06 Thread zkim
Mark- ATM, autodoc is your best bet for automatically generating documentation from your source files. The ClojureDocs lib analyzer codebase is pretty much a ns / var metadata extraction tool, similar to autodoc. Unfortunately out of the five requirements you listed [1] we only (automatically) t

Re: ClojureDocs.org week 1

2010-07-18 Thread zkim
Tom- Definitely helps, I'll add this on the next var update cycle. Thanks, Zack. On Jul 18, 12:17 pm, Tom Faulhaber wrote: > What I've noticed is that conventions on doc string indentation is all > over the place. Combine that with the fact that folks build tables and > columns by hand, and a r

Re: ClojureDocs.org

2010-07-17 Thread zkim
Islon- See the week 1 post on the CD.org group (http:// groups.google.com/group/clojuredocsorg/browse_thread/thread/ af7edbf85a6607c4) as to where this fits in on the timeline. Lee- Very cool, I've added it to the UserVoice page. Daniel- I agree, a great search experience is key for documentation

ClojureDocs.org week 1

2010-07-17 Thread zkim
Hi All- I've just posted a summary of feedback and the plan moving forward for ClojureDocs.org (http://groups.google.com/group/clojuredocsorg/ browse_thread/thread/af7edbf85a6607c4). If you're interested in being involved in shaping the site please take a look (and sign up for the group). I'd li

Re: ClojureDocs.org

2010-07-11 Thread zkim
> On Sun, Jul 11, 2010 at 8:14 AM, Phil Hagelberg wrote: > > On Sat, Jul 10, 2010 at 11:23 PM, zkim wrote: > >>> but what do you think about using Justin's codebase, or an Aleph-based > >>> server to > >>> host the thing instead of Ruby/Rails? (see t

Re: ClojureDocs.org

2010-07-11 Thread zkim
Lukasz- > Hoping for the categories to arrive to the core namespace. This really > saves a lot of time for a clojure beginner like me. The way Justin did this is great (http://clojure-examples.appspot.com/ clojure.core). I'm hoping to add this in the near future. > Additionally, I'd prefer if th

Re: ClojureDocs.org

2010-07-11 Thread zkim
n the Clojure web space (even just since May). It's a tough problem to get right, and I'm definitely willing to help those that have taken up this difficult challenge any way I can. -Zack On Jul 11, 8:14 am, Phil Hagelberg wrote: > On Sat, Jul 10, 2010 at 11:23 PM, zkim wrote: &g

Re: ClojureDocs.org

2010-07-11 Thread zkim
Stu- > (2) +1 on hiding private APIs. We use private APIs carefully and > deliberately in Clojure, and I would hate to facilitate people > writing code that will break later. That's +4 on this one by my tally, I'll pull the private vars. > (3) +1 on making it very easy to see which version of a

Re: ClojureDocs.org

2010-07-10 Thread zkim
Shantanu- > One suggestion -- consider providing a downloadable > bundle for offline use as well. I believe there's an item up on the UserVoice page (http:// clojuredocs.uservoice.com/) keep an eye out for updates and comments there. -Zack On Jul 10, 3:29 am, Shantanu Kumar wrote: > This is g

Re: ClojureDocs.org

2010-07-10 Thread zkim
Heinz- > first of all, great effort there :) having a place for clojure docs is > awesome. Thanks, appreciated. > 1) http://github.com/defn/walton - have a look at it, it might be a > good way to fetch examples for functions where none are provided yet. I'll take a look. > 2) Will it be po

Re: ClojureDocs.org

2010-07-10 Thread zkim
(example map) > >> clojure.core/map (since 1.0) > > >> (map inc [1 2 3 4 5]) > >> (2 3 4 5 6) > > >> There are of course many variants of some functions and different > >> forms of use, so dealing with the best way to provide useful help > >&

Re: ClojureDocs.org

2010-07-10 Thread zkim
re of course many variants of some functions and different > > forms of use, so dealing with the best way to provide useful help > > without an overwhelming number of examples is tricky in the repl, but > > I think worth doing.  Along with doc and source, I think example would >

Re: ClojureDocs.org

2010-07-09 Thread zkim
explicitly included by the user? -Zack On Jul 9, 2:06 pm, Tom Faulhaber wrote: > Quick thought: You probably don't want to include private vars. > > On Jul 9, 1:32 am, zkim wrote: > > > > > Hi All, > > > I'll try to keep this short. > > > I've gott

Re: ClojureDocs.org

2010-07-09 Thread zkim
ressed interest in making code contributions. > > Zack, you had mentioned you planned to keep the source of your site > proprietary -- is that set in stone? > > Justin > > On Jul 9, 12:21 pm, David Nolen wrote: > > > > > On Fri, Jul 9, 2010 at 4:32 AM, zkim wrote:

Re: ClojureDocs.org

2010-07-09 Thread zkim
I've put these suggestions up on the UserVoice page, I believe I got all of them, but if I missed yours please add it yourself or let me know. Dimitri: I share your frustrations with having to remember yet another login / password. Other than minor cosmetic fixes, improving the user signup / login

Re: ClojureDocs.org

2010-07-09 Thread zkim
. On Jul 9, 10:30 am, ".Bill Smith" wrote: > Having contributed a lot of examples to clojure-examples.appspot.com > this week, I agree that it would be a shame to duplicate efforts. > > On Jul 9, 11:21 am, David Nolen wrote: > > > > > On Fri, Jul 9, 2010 at 4:32

ClojureDocs.org

2010-07-09 Thread zkim
Hi All, I'll try to keep this short. I've gotten a lot out of Clojure: I can honestly say that learning this language, and being part of this community has made me a better, happier developer, and I wanted to give something back. One of the pain points that I encountered when learning the langua