Re: Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-10-01 Thread Andy Fingerhut
ember 30, 2014 5:52:14 AM UTC+8, Andy Fingerhut wrote: >> >> The Clojure cheat sheet with links to ClojureDocs.org [2] now also links >> to ClojureDocs.org for things added since Clojure 1.4, because now >> ClojureDocs.org [1] has been updated to include all of those things. I

Re: Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-10-01 Thread John Louis Del Rosario
: > > The Clojure cheat sheet with links to ClojureDocs.org [2] now also links > to ClojureDocs.org for things added since Clojure 1.4, because now > ClojureDocs.org [1] has been updated to include all of those things. I > suspect Zachary Kim, or perhaps several people, deserve a ro

Re: Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-10-01 Thread Sergey Didenko
https://github.com/zk/clojuredocs#clojure-version > > On Monday, September 29, 2014 2:52:14 PM UTC-7, Andy Fingerhut wrote: >> >> The Clojure cheat sheet with links to ClojureDocs.org [2] now also links >> to ClojureDocs.org for things added since Clojure 1.4, because now >&g

Re: Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-09-29 Thread Andy Fingerhut
As usual, the latest Clojure cheat sheets are available at [2]. The >> version at clojure.org/cheatsheet <http://clojure.org/cheatsheet> will >> be updated some time to match. >> >> Andy >> >> [1] http://clojuredocs.org >> [2] http://jafingerhut.github.io

Re: Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-09-29 Thread gvim
On 29/09/2014 22:52, Andy Fingerhut wrote: As usual, the latest Clojure cheat sheets are available at [2]. The version at clojure.org/cheatsheet <http://clojure.org/cheatsheet> will be updated some time to match. Andy [1] http://clojuredocs.org [2] http://jafingerhut.github.io Any

Re: Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-09-29 Thread zk
jure cheat sheet with links to ClojureDocs.org [2] now also links > to ClojureDocs.org for things added since Clojure 1.4, because now > ClojureDocs.org [1] has been updated to include all of those things. I > suspect Zachary Kim, or perhaps several people, deserve a round of applause > f

Clojure cheat sheet now links to ClojureDocs.org for things added since Clojure 1.4

2014-09-29 Thread Andy Fingerhut
The Clojure cheat sheet with links to ClojureDocs.org [2] now also links to ClojureDocs.org for things added since Clojure 1.4, because now ClojureDocs.org [1] has been updated to include all of those things. I suspect Zachary Kim, or perhaps several people, deserve a round of applause for all of

Re: Regarding http://clojuredocs.org

2013-10-10 Thread Stefan du Fresne
lso the Search feature at http://clojuredocs.org is awesome. Personally, > as a newbie , I find it very helpful, to be able to search and see the > examples. > > I didn't find the same at http://clojure.org/documentation, > http://clojure.github.io/clojure or at http://clojure

Re: Regarding http://clojuredocs.org

2013-10-10 Thread binita
Yes , agree with puzzler . Also the Search feature at http://clojuredocs.org is awesome. Personally, as a newbie , I find it very helpful, to be able to search and see the examples. I didn't find the same at http://clojure.org/documentation, http://clojure.github.io/clojure or at

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Mark Engelberg
Sometimes, it's also useful to be able to take things out. I keep seeing people get confused by clojuredocs references to contrib libraries that have completely different names now. -- -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Andy Fingerhut
For all but the few functions and macros added to Clojure since 1.3, ClojureDocs can be as actively maintained as people choose to update it. I add new facts that come to my attention there every so often, e.g.: http://clojuredocs.org/clojure_core/clojure.core/subs http://clojuredocs.org

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Bruce Wang
link to the original blog posts > which outline the idea, but are by no means thorough. It would be great to > get back to having an active documentation repository for community > contributions. > Yep, you are right, I didn't realise The Clojure Cheatsheet[1] is actually pointing t

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Mark Engelberg
On Tue, Oct 8, 2013 at 9:55 PM, Bruce Wang wrote: > The official docs is at http://clojure.org/documentation, > http://clojure.github.io/clojure/ > > > Sure, but the nice thing about clojuredocs is that it includes examples for most of the functions and for a while, it was updated more frequently

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Marek Kubica
On Tue, 8 Oct 2013 21:55:08 -0700 Andy Fingerhut wrote: > Those who created ClojureDocs.org made some progress towards > rewriting the server side code in Clojure (it was originally > developed in Ruby on Rails, IIRC), but have found it challenging to > find enough time to finish t

Re: Regarding http://clojuredocs.org

2013-10-08 Thread Andy Fingerhut
Those who created ClojureDocs.org made some progress towards rewriting the server side code in Clojure (it was originally developed in Ruby on Rails, IIRC), but have found it challenging to find enough time to finish that work. I recall a month or two ago someone mentioning that they would be

Re: Regarding http://clojuredocs.org

2013-10-08 Thread Bruce Wang
The official docs is at http://clojure.org/documentation, http://clojure.github.io/clojure/ On Wed, Oct 9, 2013 at 2:13 PM, binita wrote: > Hello everyone , > > Latest version of Clojure is 1.5. > But, http://clojuredocs.org only show docs for 1.2 and 1.3 versions. How > ab

Regarding http://clojuredocs.org

2013-10-08 Thread binita
Hello everyone , Latest version of Clojure is 1.5. But, http://clojuredocs.org only show docs for 1.2 and 1.3 versions. How about 1.4 and 1.5 documentation ? Thanks Binita -- -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Andy Fingerhut
Cedric: At the bottom of the main clojuredocs.org page is the text below. I've copied it here because perhaps the best way to get such changes made is to contribute changes to the code of the clojuredocs.org web site. At the least, it would be good to open a case. You'll have to

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Andy Fingerhut
eate a free account on clojuredocs.org and edit away. Instant gratification :-) Because of this, you do need to take the examples there with a critical eye, but on average they are quite good. Convince a Clojure contributor to make changes to doc strings, or to the docs hosted on clojure.org. The

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Alex Miller
Done. On Feb 27, 10:00 am, Brian Marick wrote: > On Feb 27, 2012, at 1:22 AM, Andy Fingerhut wrote: > > > Thanks to several people who provided feedback, especially Steve Miner, and > > to Alex Miller for updating the web site yet again, there is a new > > cheatsheet at: > > >http://clojure.org

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Alex Miller
All of the links now point to clojuredocs, where anyone can add examples. I'm not sure where Andy hosts the latex source and code to generate everything for the cheatsheet contents? On Feb 27, 7:57 am, Bill Caputo wrote: > On Feb 27, 2012, at 1:22 AM, Andy Fingerhut wrote: > > > Thanks to seve

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-27 Thread Alex Miller
That's part of the site-wide template - afaik only the Organizer roles (not me) have the ability to change it. Those people are: Rich, Stu, Tom Hickey, and Chris Redinger. On Feb 15, 3:45 pm, Phil Hagelberg wrote: > Andy Fingerhut writes: > > Fogus, Alex Millier, and I have made some updates to

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Brian Marick
On Feb 27, 2012, at 1:22 AM, Andy Fingerhut wrote: > Thanks to several people who provided feedback, especially Steve Miner, and > to Alex Miller for updating the web site yet again, there is a new cheatsheet > at: > > http://clojure.org/cheatsheet Excellent. Might be helpful to put 1.3 in th

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Cedric Greevey
On Mon, Feb 27, 2012 at 8:57 AM, Bill Caputo wrote: > This is fantastic guys... thank you. Agreed. Particularly, you can see syntax-highlighted source in the same page now. Previously, if you clicked through to a function and clicked through to the source, it sent you to a github page that (usua

Re: Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-27 Thread Bill Caputo
On Feb 27, 2012, at 1:22 AM, Andy Fingerhut wrote: > Thanks to several people who provided feedback, especially Steve Miner, and > to Alex Miller for updating the web site yet again, there is a new cheatsheet > at: This is fantastic guys... thank you. One question: if one wants to help out wi

Clojure 1.3 updated cheatsheet with links to clojuredocs.org

2012-02-26 Thread Andy Fingerhut
early February, 2012, but here are the main ones: + New today: most links on the page now go to the documentation on clojuredocs.org. These pages have not only the documentation that the old links had, but also one click to see the source code of the function, and very often user-contributed

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-20 Thread Andy Fingerhut
ge.mac.com/jafingerhut/files/cheatsheet-clj-1.3.0-v1.2/cheats >> heet-full.html >> >> with links to clojuredocs.org: >> >> http://homepage.mac.com/jafingerhut/files/cheatsheet-clj-1.3.0-v1.2/cheats >> heet-clojuredocs.html > > Andy, > > Thanks for

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-20 Thread Andy Fingerhut
links to docs on clojure.org: http://homepage.mac.com/jafingerhut/files/cheatsheet-clj-1.3.0-v1.2/cheatsheet-full.html with links to clojuredocs.org: http://homepage.mac.com/jafingerhut/files/cheatsheet-clj-1.3.0-v1.2/cheatsheet-clojuredocs.html Note: clojuredocs.org documentation for disj

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-15 Thread Phil Hagelberg
Andy Fingerhut writes: > Fogus, Alex Millier, and I have made some updates to the Clojure > cheatsheet for Clojure 1.3.0: > > http://clojure.org/cheatsheet Looks good. I did notice the copyright date in the footer is wrong though. -Phil -- You received this message because you are subscribed

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-15 Thread sean neilan
re.org/cheatsheet >> >> The links there go to the generated documentation on clojure.github.com. >> Below is a version that is the same as the one above, except that its links >> go to the appropriate page on clojuredocs.org. All of those have the >> documentation st

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-15 Thread Sean Corfield
ure cheatsheet > for Clojure 1.3.0: > > http://clojure.org/cheatsheet > > The links there go to the generated documentation on clojure.github.com.   > Below is a version that is the same as the one above, except that its links > go to the appropriate page on clojuredocs.org

Re: Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-15 Thread Manuel Paccagnella
above, except that its links go to the appropriate page on clojuredocs.org. All of those have the documentation string and a link to the source, and many of them also show examples of their use. I can't vouch for the correctness of all of the examples, but anyone is welcome to improve th

Clojure 1.3.0 updated cheatsheet, and one with links to clojuredocs.org

2012-02-15 Thread Andy Fingerhut
appropriate page on clojuredocs.org. All of those have the documentation string and a link to the source, and many of them also show examples of their use. I can't vouch for the correctness of all of the examples, but anyone is welcome to improve them by creating a free account on that site and ed

Re: API for ClojureDocs.org

2010-09-06 Thread Moritz Ulrich
One of the most important things for me is the access to code examples. Every example could be split in multiple parts. (comment, function and result part for example) Editors (Emacs + Slime) could display these in a nicely and decent manner while developing. Also, bulk-get could be helpful (to ma

Re: API for ClojureDocs.org

2010-09-06 Thread Zmitro Lapcjonak
On Sep 3, 2:11 am, Lee Hinman wrote: > working on the API for ClojureDocs.org in the coming future. I was > hoping to get some feedback regarding what people wanted to see for an > API for ClojureDocs: > Any other feedback is highly appreciated :) when i added examples, i thinked

Re: API for ClojureDocs.org

2010-09-02 Thread Rayne
jure. My vote is on JSON. On Sep 2, 6:11 pm, Lee Hinman wrote: > Hi All, > As Zach announced in the ClojureDocs mailing list [1], I'm going to be > working on the API for ClojureDocs.org in the coming future. I was > hoping to get some feedback regarding what people wanted to see for

API for ClojureDocs.org

2010-09-02 Thread Lee Hinman
Hi All, As Zach announced in the ClojureDocs mailing list [1], I'm going to be working on the API for ClojureDocs.org in the coming future. I was hoping to get some feedback regarding what people wanted to see for an API for ClojureDocs: - What kind of features would you like to see i

Re: ClojureDocs.org week 1

2010-07-18 Thread zkim
seems to make all the doc strings I've encountered in the wild > format up pretty well. > > HTH, > > Tom > > On Jul 17, 2:52 am, Tassilo Horn wrote: > > > > > Hi Zack, > > > I just had a look at ClojureDocs.org and it's really neat! >

Re: ClojureDocs.org week 1

2010-07-18 Thread Tom Faulhaber
gt; > I just had a look at ClojureDocs.org and it's really neat! > > Some observations I made: > > - When I view the docs of let's say clojure.set/rename, the clojure.set >   part is a link.  But instead of pointing to to clojure.set summary >   page, it is only http:. >

Re: ClojureDocs.org week 1

2010-07-17 Thread Tassilo Horn
Hi Zack, I just had a look at ClojureDocs.org and it's really neat! Some observations I made: - When I view the docs of let's say clojure.set/rename, the clojure.set part is a link. But instead of pointing to to clojure.set summary page, it is only http:. - In the source sectio

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 gr

Re: ClojureDocs.org

2010-07-16 Thread Avram
A few thoughts... It might be interesting to allow examples to be rated. Quality or usefulness of the provided example could then be inferred from the rating and highly rated examples could bubble to the top or have the associated rating prominently shown. ~A On Jul 16, 10:29 am, Lee Hinman wro

Re: ClojureDocs.org

2010-07-16 Thread Daniel Werner
Hi Zack, I just take a quick look at your site and must say that I'm impressed. This is going to become one of the utilities I constantly keep open in the background while developing. Especially since features like the Var cross-referencing tend to make easier to get the "big picture". One thing

Re: ClojureDocs.org

2010-07-16 Thread Lee Hinman
Had another suggestion, As an example contributor, It would be really nice to see a list of functions that have no examples yet at a glance, so if I wanted to work on adding examples I could go through a list and work on functions that have no examples. I believe the clojure-examples appspot wiki

Re: ClojureDocs.org

2010-07-16 Thread Islon Scherer
Hi. Does clojuredocs expose any external API (json, xml... rest, webservices, etc) so I can access the docs from my code? Islon On Jul 13, 11:40 pm, j-g-faustus wrote: > On Jul 13, 8:37 pm, Paul Moore wrote: > > > Can I suggest omitting the "Table of contents" sidebar when printing? > > I've n

Re: ClojureDocs.org

2010-07-13 Thread j-g-faustus
On Jul 13, 8:37 pm, Paul Moore wrote: > Can I suggest omitting the "Table of contents" sidebar when printing? > I've not tried printing the document to see how it looks, but removing > the sidebar would be an essential starting point... Why would anyone want to print it? I occasionally print lon

Re: ClojureDocs.org

2010-07-13 Thread Rick Moynihan
On 11 July 2010 12:05, Lukasz Urbanek wrote: > Looks very nice! > > Hoping for the categories to arrive to the core namespace. This really > saves a lot of time for a clojure beginner like me. +1 > Additionally, I'd prefer if the source was wasn't exposed by default > (It's quite distracting whe

Re: ClojureDocs.org

2010-07-13 Thread Meikel Brandmeyer
Hi, Am 13.07.2010 um 14:26 schrieb j-g-faustus: >>> I made my own cheat sheet for private use over the past month or so, >>> core functions only. It's at the 80% stage, I don't expect it will >>> ever be 100%, but I have found it useful: >>> http://faustus.webatu.com/clj-quick-ref.html Some comm

Re: ClojureDocs.org

2010-07-13 Thread .Bill Smith
I agree. The in-code function documentation serves its purpose but could be improved upon in a medium where space is at less of a premium. Bill Smith Austin, TX On Jul 10, 12:36 pm, James Reeves wrote: > On 10 July 2010 15:06, Stuart Halloway wrote: > > > (6) Because docstrings are designed f

Re: ClojureDocs.org

2010-07-13 Thread Paul Moore
On 12 July 2010 23:25, j-g-faustus wrote: > The site looks very nice, I especially like the "find real world > examples" functionality and the fact that it collects documentation > for common non-core libraries as well. > > I made my own cheat sheet for private use over the past month or so, > cor

Re: ClojureDocs.org

2010-07-13 Thread j-g-faustus
On 13 Jul, 01:28, j-g-faustus wrote: > On Jul 13, 12:25 am, j-g-faustus wrote: > > > I made my own cheat sheet for private use over the past month or so, > > core functions only. It's at the 80% stage, I don't expect it will > > ever be 100%, but I have found it useful: > > http://faustus.webatu.

Re: ClojureDocs.org

2010-07-12 Thread j-g-faustus
On Jul 13, 12:25 am, j-g-faustus wrote: > I made my own cheat sheet for private use over the past month or so, > core functions only. It's at the 80% stage, I don't expect it will > ever be 100%, but I have found it useful: > http://faustus.webatu.com/clj-quick-ref.html Looks like the hosting pro

Re: ClojureDocs.org

2010-07-12 Thread j-g-faustus
The site looks very nice, I especially like the "find real world examples" functionality and the fact that it collects documentation for common non-core libraries as well. I made my own cheat sheet for private use over the past month or so, core functions only. It's at the 80% stage, I don't expec

Re: ClojureDocs.org

2010-07-12 Thread Phil Hagelberg
On Sun, Jul 11, 2010 at 4:10 PM, zkim wrote: > If you're willing to continue the discussion, I'd like to keep this > going (maybe another thread?).  As I'm writing this I'm getting the > feeling that I'm not quite articulating my thoughts well, and I think > further discussion will help me to fles

Re: ClojureDocs.org

2010-07-11 Thread Daniel Pritchett
As a Clojure novice I'm happy to see the documentation side of the Clojure ecosystem growing regardless of the stack used for a doc site. Having a resource like a user-edited php.net will be a great help. I am excited about submitting a few examples of my own. On Jul 11, 9:14 am, Phil Hagelberg w

Re: ClojureDocs.org

2010-07-11 Thread Luc Préfontaine
We use Rails for all our GUIs, we need simple CRUD most of the time and we ActiveScaffold. Most of our controllers are less than 70 lines and we seldom write forms. We use the ActiveScaffold partial forms almost every were sometimes custpmizing them. Clojure Web Frameworks are not there yet. We

Re: ClojureDocs.org

2010-07-11 Thread zkim
Rich- > It sounded to me like he was only saying that he's more familiar with > Ruby/Rails than he is with Clojure. Correct. I think it was a fair question, and I'm happy to provide insights into my decision making process. -Zack On Jul 11, 12:37 pm, Richard Lyman wrote: > On Sun, Jul 11, 201

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
Phil- A little background on my clojure web experience: I've got a intranet web tool written using ring / enlive / moustache (system health / monitoring for a personal project) as well as dabbled in compojure before the 0.4.0 rev, and more recently I've been looking at sandbar / carte. The timefra

Re: ClojureDocs.org

2010-07-11 Thread Richard Lyman
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 the link above for more details) >> >> I'm inclined to mo

Re: ClojureDocs.org

2010-07-11 Thread Lukasz Urbanek
Looks very nice! Hoping for the categories to arrive to the core namespace. This really saves a lot of time for a clojure beginner like me. Additionally, I'd prefer if the source was wasn't exposed by default (It's quite distracting when one is looking for the examples), some kind of "source" but

Re: ClojureDocs.org

2010-07-11 Thread Phil Hagelberg
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 the link above for more details) > > I'm inclined to move forward with the Ruby / Rails for now.  The > reason I went

Re: ClojureDocs.org

2010-07-11 Thread zkim
ted to taking whatever measures are necessary to ensure that the hard work that went into adding content to the site would not be lost. I'll start a thread over at the clojuredocs.org group to discuss this. > Because docstrings are designed for consumption at a REPL, > they may in

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
egorization suggestions you have for your lib. Ultimately I'd like to get clojuredocs.org to the point where you can enter a repo url into a web form and click 'add / update' (or maybe some code that watches a repo for updates). On Jul 10, 3:11 am, "Heinz N. Gies" wro

Re: ClojureDocs.org

2010-07-10 Thread zkim
y/Rails? (see the link > above for more details) > > On Jul 9, 2010, at 7:05 PM, Justin Kramer wrote: > > > > > An "examples" function for the REPL that pulls from the wiki: > > >http://gist.github.com/470031 > > > I'm sure something like it could be

Re: ClojureDocs.org

2010-07-10 Thread zkim
> http://gist.github.com/470031 > > I'm sure something like it could be made for ClojureDocs.org once the > API is in place. Nice, looks pretty straightforward. > I think an important aspect of a > collaborative tool like this is quality control. To that end, a > compl

Re: ClojureDocs.org

2010-07-10 Thread Luc Préfontaine
Zack if you need help with this Rail app let us now. We can give you a hand, the wish list keeps growing :))) Luc P. Sent from my iPod On 2010-07-09, at 15:07, zkim wrote: Hi Justin, thanks again for the go-ahead to pull examples from http://clojure-examples.appspot.com. Zack, you had me

Re: ClojureDocs.org

2010-07-10 Thread James Reeves
On 10 July 2010 15:06, Stuart Halloway wrote: > (6) Because docstrings are designed for consumption at a REPL, they may in > some cases presume a fixed font. Worth considering for display on the site. What about giving function documentation the same "wiki" behaviour that the examples have? Star

Re: ClojureDocs.org

2010-07-10 Thread Stuart Halloway
://clojuredocs.org looks good on this front. Stick to it. (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. (3) +1 on making it very easy to see which version of an API you are looking at

Re: ClojureDocs.org

2010-07-10 Thread James Reeves
On 9 July 2010 21:06, Tom Faulhaber wrote: > Quick thought: You probably don't want to include private vars. Seconded. It's a little confusing seeing private vars and macros in the API docs! Other than that, this looks excellent. I'm signing up as I write this. - James -- You received this me

Re: ClojureDocs.org

2010-07-10 Thread RobertLJ
en time. So I took a whack at > the problem, and came up withhttp://clojuredocs.org.  It's a site > that (I'm hoping) will fill this need by providing a centralized > examples database, along with solid search capabilities across both > core and third party libraries (core being

Re: ClojureDocs.org

2010-07-10 Thread Shantanu Kumar
This is great. One suggestion -- consider providing a downloadable bundle for offline use as well. Regards, Shantanu On Jul 10, 2:11 pm, "Heinz N. Gies" wrote: > Hi Zack, > first of all, great effort there :) having a place for clojure docs is > awesome. Two things come to mind: > > 1)http://gi

Re: ClojureDocs.org

2010-07-10 Thread Heinz N. Gies
Hi Zack, first of all, great effort there :) having a place for clojure docs is awesome. Two things come to mind: 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. 2) Will it be possible to put other 3rd par

Re: ClojureDocs.org

2010-07-09 Thread Meikel Brandmeyer
Hi, Am 09.07.2010 um 23:47 schrieb zkim: > I kind of went back and forth on this. Originally I only parsed out > public vars, but in a couple of instances I found that when tracing > through some code I would hit on private vars. I'm suspicious of showing source code to the reader with everythi

Re: ClojureDocs.org

2010-07-09 Thread Greg
Rails? (see the link above for more details) On Jul 9, 2010, at 7:05 PM, Justin Kramer wrote: > An "examples" function for the REPL that pulls from the wiki: > > http://gist.github.com/470031 > > I'm sure something like it could be made for ClojureDocs.org on

Re: ClojureDocs.org

2010-07-09 Thread Justin Kramer
An "examples" function for the REPL that pulls from the wiki: http://gist.github.com/470031 I'm sure something like it could be made for ClojureDocs.org once the API is in place. General comments on ClojureDocs.org: I think an important aspect of a collaborative tool like

Re: ClojureDocs.org

2010-07-09 Thread zkim
was a lack of examples specific to the individual functions I was > > trying to wrap my head around at any given time. So I took a whack at > > the problem, and came up withhttp://clojuredocs.org.  It's a site > > that (I'm hoping) will fill this need by providing a centra

Re: ClojureDocs.org

2010-07-09 Thread John Cromartie
functions I was > trying to wrap my head around at any given time. So I took a whack at > the problem, and came up withhttp://clojuredocs.org.  It's a site > that (I'm hoping) will fill this need by providing a centralized > examples database, along with solid search capabilitie

Re: ClojureDocs.org

2010-07-09 Thread Gavin Heavyside
On 9 July 2010 09:32, zkim wrote: > > Questions / thoughts? > > Looks really good to me. Could you display the version numbers for Clojure and the libraries that the site covers? Gavin -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to thi

Re: ClojureDocs.org

2010-07-09 Thread zkim
Hi Justin, thanks again for the go-ahead to pull examples from http://clojure-examples.appspot.com. > Zack, you had mentioned you planned to keep the source of your site > proprietary -- is that set in stone? Definitely not set in stone. As far as the site goes there's not much Clojure going on

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
Thanks all for your kind words. As to the specifics: > The headers for each section (Doc, Source, Example(s)) don't > differentiate themselves from the regular doc text enough, maybe > bold/underline/color them to make them show up more? I'd agree, I think the visual styling of the page will cha

Re: ClojureDocs.org

2010-07-09 Thread Lee Hinman
On Fri, Jul 9, 2010 at 2:32 AM, zkim wrote: > Hi All, > > Questions / thoughts? > > -Zack Hi Zack, First off, I think it looks great, and it definitely seems useful when trying to find an example of a particular API call. Few suggestions: 1. The headers for each section (Doc, Source, Example(s))

Re: ClojureDocs.org

2010-07-09 Thread Tom Faulhaber
k a whack at > the problem, and came up withhttp://clojuredocs.org.  It's a site > that (I'm hoping) will fill this need by providing a centralized > examples database, along with solid search capabilities across both > core and third party libraries (core being the focus). > > I

Re: ClojureDocs.org

2010-07-09 Thread Justin Kramer
I've told Zack that he is free to pull any examples from the wiki for use on his site. I don't know about collaboration beyond that. The wiki is open source and written in Clojure; anyone is free to contribute/fork. At least one person has expressed interest in making code contributions. Zack, yo

Re: ClojureDocs.org

2010-07-09 Thread Alex Miller
nguage > was a lack of examples specific to the individual functions I was > trying to wrap my head around at any given time. So I took a whack at > the problem, and came up withhttp://clojuredocs.org.  It's a site > that (I'm hoping) will fill this need by providing a centralized

Re: ClojureDocs.org

2010-07-09 Thread Dmitry Kakurin
any given time. So I took a whack at > the problem, and came up withhttp://clojuredocs.org.  It's a site > that (I'm hoping) will fill this need by providing a centralized > examples database, along with solid search capabilities across both > core and third party libraries (core being the

Re: ClojureDocs.org

2010-07-09 Thread .Bill Smith
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 AM, zkim wrote: > > > Questions / thoughts? > > > -Zack > > This is great. I think the main

Re: ClojureDocs.org

2010-07-09 Thread David Nolen
On Fri, Jul 9, 2010 at 4:32 AM, zkim wrote: > > Questions / thoughts? > > -Zack This is great. I think the main thing is not duplicating effort. This and clojure-examples.appspot.com should really join forces. David -- You received this message because you are subscribed to the Google Groups

Re: ClojureDocs.org

2010-07-09 Thread Lee Hinman
On Fri, Jul 9, 2010 at 2:32 AM, zkim wrote: > Hi All, > > Questions / thoughts? > > -Zack Hi Zack, First off, I think it looks great, and it definitely seems useful when trying to find an example of a particular API call. Few suggestions: 1. The headers for each section (Doc, Source, Example(s))

Re: ClojureDocs.org

2010-07-09 Thread Victor Olteanu
took a whack at > the problem, and came up with http://clojuredocs.org. It's a site > that (I'm hoping) will fill this need by providing a centralized > examples database, along with solid search capabilities across both > core and third party libraries (core being the focus). &

ClojureDocs.org

2010-07-09 Thread zkim
arning the language was a lack of examples specific to the individual functions I was trying to wrap my head around at any given time. So I took a whack at the problem, and came up with http://clojuredocs.org. It's a site that (I'm hoping) will fill this need by providing a centralized exam