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

2014-10-01 Thread Sergey Didenko
, 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 ClojureDocs.org [1] has been updated to include all of those things. I suspect Zachary Kim

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 round of applause

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

2014-10-01 Thread Andy Fingerhut
, 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 suspect Zachary Kim, or perhaps several people, deserve

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

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

2014-09-29 Thread zk
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 the hard work that went into the updated

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 chance

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

2014-09-29 Thread Andy Fingerhut
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 chance of an updated cljs-cheatsheet? The one listed on the same github

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 http

Re: Regarding http://clojuredocs.org

2013-10-10 Thread Stefan du Fresne
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-doc.org though. Thanks On Thursday

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Marek Kubica
On Tue, 8 Oct 2013 21:55:08 -0700 Andy Fingerhut andy.finger...@gmail.com 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

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Mark Engelberg
On Tue, Oct 8, 2013 at 9:55 PM, Bruce Wang br...@brucewang.net 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

Re: Regarding http://clojuredocs.org

2013-10-09 Thread Bruce Wang
, 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 to clojuredocs.org [1] http://jafingerhut.github.io/cheatsheet-clj-1.3

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 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

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 this group

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

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 binita.bhar...@gmail.com 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

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 with

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 logos...@gmail.com 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

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 the

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 p...@hagelb.org wrote: Andy Fingerhut andy.finger...@gmail.com writes: Fogus, Alex

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 logos...@gmail.com wrote: On Feb 27, 2012, at 1:22 AM, Andy Fingerhut wrote:

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 mar...@exampler.com 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:

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

2012-02-27 Thread Andy Fingerhut
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 best way to do

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 go

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
), with 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-20 Thread Andy Fingerhut
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 your service. I attach two screenshots taken with ffox 10.0.2 on os x 7, I think some of the styles got mangled? The left and right columns

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

2012-02-15 Thread Andy Fingerhut
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 them by creating a free account on that site and editing

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 them

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

2012-02-15 Thread Sean Corfield
updates to the Clojure 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.  All of those

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

2012-02-15 Thread sean neilan
/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 string and a link to the source, and many of them

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

2012-02-15 Thread Phil Hagelberg
Andy Fingerhut andy.finger...@gmail.com 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

Re: API for ClojureDocs.org

2010-09-06 Thread Zmitro Lapcjonak
On Sep 3, 2:11 am, Lee Hinman matthew.hin...@gmail.com 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

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

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

Re: API for ClojureDocs.org

2010-09-02 Thread Rayne
is on JSON. On Sep 2, 6:11 pm, Lee Hinman matthew.hin...@gmail.com 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 an API

Re: ClojureDocs.org week 1

2010-07-18 Thread Tom Faulhaber
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 section, not all referenced vars

Re: ClojureDocs.org week 1

2010-07-18 Thread zkim
encountered in the wild format up pretty well. HTH, Tom On Jul 17, 2:52 am, Tassilo Horn tass...@member.fsf.org wrote: 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

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

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

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 section, not all

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 johannes.fries...@gmail.com wrote: On Jul 13, 8:37 pm, Paul Moore p.f.mo...@gmail.com wrote: Can I suggest omitting the Table of

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 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 I

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

Re: ClojureDocs.org

2010-07-13 Thread j-g-faustus
On 13 Jul, 01:28, j-g-faustus johannes.fries...@gmail.com wrote: On Jul 13, 12:25 am, j-g-faustus johannes.fries...@gmail.com 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

Re: ClojureDocs.org

2010-07-13 Thread Paul Moore
On 12 July 2010 23:25, j-g-faustus johannes.fries...@gmail.com 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

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 jree...@weavejester.com wrote: On 10 July 2010 15:06, Stuart Halloway stuart.hallo...@gmail.com

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 comments after

Re: ClojureDocs.org

2010-07-13 Thread Rick Moynihan
On 11 July 2010 12:05, Lukasz Urbanek resc...@gmail.com 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

Re: ClojureDocs.org

2010-07-13 Thread j-g-faustus
On Jul 13, 8:37 pm, Paul Moore p.f.mo...@gmail.com 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

Re: ClojureDocs.org

2010-07-12 Thread Phil Hagelberg
On Sun, Jul 11, 2010 at 4:10 PM, zkim zachary@gmail.com 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

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 expect

Re: ClojureDocs.org

2010-07-12 Thread j-g-faustus
On Jul 13, 12:25 am, j-g-faustus johannes.fries...@gmail.com 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

Re: ClojureDocs.org

2010-07-11 Thread zkim
: 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 this is quality control

Re: ClojureDocs.org

2010-07-11 Thread zkim
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 he...@licenser.net wrote: Hi Zack, first of all, great effort

Re: ClojureDocs.org

2010-07-11 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

Re: ClojureDocs.org

2010-07-11 Thread zkim
. 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 some cases presume a fixed font. Worth considering for display on the site. Sounds good, fix is up on the site. Quality matters. There are multiple

Re: ClojureDocs.org

2010-07-11 Thread Phil Hagelberg
On Sat, Jul 10, 2010 at 11:23 PM, zkim zachary@gmail.com 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

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

Re: ClojureDocs.org

2010-07-11 Thread Richard Lyman
On Sun, Jul 11, 2010 at 8:14 AM, Phil Hagelberg p...@hagelb.org wrote: On Sat, Jul 10, 2010 at 11:23 PM, zkim zachary@gmail.com 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

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

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 the

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 richard.ly...@gmail.com wrote:

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.

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

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

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 he...@licenser.net wrote: Hi Zack, first of all, great effort there :) having a place for clojure docs is awesome. Two things come to mind:

Re: ClojureDocs.org

2010-07-10 Thread RobertLJ
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). Implementation: ClojureDocs.org is a rails

Re: ClojureDocs.org

2010-07-10 Thread James Reeves
On 9 July 2010 21:06, Tom Faulhaber tomfaulha...@gmail.com 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 --

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

Re: ClojureDocs.org

2010-07-10 Thread James Reeves
On 10 July 2010 15:06, Stuart Halloway stuart.hallo...@gmail.com 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

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 zachary@gmail.com wrote: Hi Justin, thanks again for the go-ahead to pull examples from

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 complete list of recent updates

ClojureDocs.org

2010-07-09 Thread zkim
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 examples database, along

Re: ClojureDocs.org

2010-07-09 Thread Victor Olteanu
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). Implementation: ClojureDocs.org is a rails site backed by MySQL, along

Re: ClojureDocs.org

2010-07-09 Thread Lee Hinman
On Fri, Jul 9, 2010 at 2:32 AM, zkim zachary@gmail.com 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,

Re: ClojureDocs.org

2010-07-09 Thread David Nolen
On Fri, Jul 9, 2010 at 4:32 AM, zkim zachary@gmail.com 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

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 dnolen.li...@gmail.com wrote: On Fri, Jul 9, 2010 at 4:32 AM, zkim zachary@gmail.com wrote: Questions / thoughts? -Zack

Re: ClojureDocs.org

2010-07-09 Thread Dmitry Kakurin
://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). Implementation: ClojureDocs.org is a rails site backed by MySQL, along with some

Re: ClojureDocs.org

2010-07-09 Thread Alex Miller
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 examples database, along with solid search capabilities across both core

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,

Re: ClojureDocs.org

2010-07-09 Thread Tom Faulhaber
://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). Implementation: ClojureDocs.org is a rails site backed by MySQL, along

Re: ClojureDocs.org

2010-07-09 Thread Lee Hinman
On Fri, Jul 9, 2010 at 2:32 AM, zkim zachary@gmail.com 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,

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

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 /

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 Gavin Heavyside
On 9 July 2010 09:32, zkim zachary@gmail.com 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

Re: ClojureDocs.org

2010-07-09 Thread John Cromartie
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 capabilities across both core and third party libraries (core

Re: ClojureDocs.org

2010-07-09 Thread zkim
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 capabilities across both core and third party

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 this is quality control

Re: ClojureDocs.org

2010-07-09 Thread Greg
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 once the API is in place. General comments on ClojureDocs.org: I

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 everything