Re: Clojure HTML Documentation

2008-11-26 Thread Mark Volkmann
On Fri, Nov 21, 2008 at 2:17 AM, Mark McGranaghan <[EMAIL PROTECTED]> wrote: > > I've created some experimental HTML docs for Clojure. You can see them > on S3: > http://clj-doc.s3.amazonaws.com/tmp/doc-1116/index.html A really cool addition to this would be to modify the display of the code for

Re: Clojure HTML Documentation

2008-11-23 Thread Mark McGranaghan
I've added the license notices to the bottom of each var's documentation per the discussion in #clojure - sorry about the ommision. - Mark On Sun, Nov 23, 2008 at 9:10 AM, Rich Hickey <[EMAIL PROTECTED]> wrote: > > > > On Nov 21, 3:17 am, Mark McGranaghan <[EMAIL PROTECTED]> wrote: >> I've creat

Re: Clojure HTML Documentation

2008-11-23 Thread Rich Hickey
On Nov 21, 3:17 am, Mark McGranaghan <[EMAIL PROTECTED]> wrote: > I've created some experimental HTML docs for Clojure. You can see them > on S3:http://clj-doc.s3.amazonaws.com/tmp/doc-1116/index.html > > Or, just for kicks, on Amazon's new Cloud Front > CDN:http://d2nbqsesuabw8o.cloudfront.net

Re: Clojure HTML Documentation

2008-11-23 Thread Patrick Wright
Nice. Just as input and for ideas--the JavaFX Script compiler team is working on a new documentation format instead of using the legacy JavaDoc HTML format. Basically their documentation parser produces clean XML, which they run through XSLT to produce the final, browsable HTML. The current versi

Re: Clojure HTML Documentation

2008-11-22 Thread Matt Clark
This has now become my first stop for reference information, great job! Love the changes you've made in the last few days, the searching is fantastic. --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "Clojure" group.

Re: Clojure HTML Documentation

2008-11-21 Thread Mark Volkmann
Great idea on the HTML-based documentation! Another nice addition would be showing at least one example use of each function/macro in the documentation. I realize that would take a lot of time to develop, but maybe the community could gradually build up a collection of these over time. --~--~---

Re: Clojure HTML Documentation

2008-11-21 Thread Daniel Eklund
beautiful ! thanks... i was just looking for something like this On Nov 21, 3:17 am, Mark McGranaghan <[EMAIL PROTECTED]> wrote: > I've created some experimental HTML docs for Clojure. You can see them > on S3:http://clj-doc.s3.amazonaws.com/tmp/doc-1116/index.html > > Or, just for kicks, on Ama

Re: Clojure HTML Documentation

2008-11-21 Thread Michael Beauregard
I like where you are going with this. Reminds me of www.gotapi.com. I don't know if gotapi is open or not, but your stuff may fit nicely in there. Michael On Fri, Nov 21, 2008 at 9:31 AM, Mark McGranaghan <[EMAIL PROTECTED]> wrote: > > Thanks for the thoughts Craig. > > * I'm experimenting with

Re: Clojure HTML Documentation

2008-11-21 Thread Mark McGranaghan
Thanks for the thoughts Craig. * I'm experimenting with a "namespaces" tab that will complement the current "vars" listing that is available now. * The ability to link in also sounds good, though I'll focus on that once the URL of the docs themselves is stable. * Having online docs opens up a lot

Re: Clojure HTML Documentation

2008-11-21 Thread Konrad Hinsen
On Nov 21, 2008, at 9:17, Mark McGranaghan wrote: > I've created some experimental HTML docs for Clojure. You can see them > on S3: > http://clj-doc.s3.amazonaws.com/tmp/doc-1116/index.html Very useful, thanks! Konrad. --~--~-~--~~~---~--~~ You received this m

Re: Clojure HTML Documentation

2008-11-21 Thread Craig Andera
Very nice! As it turns out, I've been heavily involved in writing the documentation infrastructure that MSDN uses for the last few years, so I have some sympathy for this problem space. :) A few things I'd like to see: * I'd like to see the URL for the page change when navigating to a new topic.

Re: Clojure HTML Documentation

2008-11-21 Thread walterc
way cool! thanks! On Nov 21, 4:17 pm, Mark McGranaghan <[EMAIL PROTECTED]> wrote: > I've created some experimental HTML docs for Clojure. You can see them > on S3:http://clj-doc.s3.amazonaws.com/tmp/doc-1116/index.html > > Or, just for kicks, on Amazon's new Cloud Front > CDN:http://d2nbqsesuabw

Clojure HTML Documentation

2008-11-21 Thread Mark McGranaghan
I've created some experimental HTML docs for Clojure. You can see them on S3: http://clj-doc.s3.amazonaws.com/tmp/doc-1116/index.html Or, just for kicks, on Amazon's new Cloud Front CDN: http://d2nbqsesuabw8o.cloudfront.net/tmp/doc-1116/index.html You can see the code I used to generate them on