Re: better community docs: getting started

2011-08-04 Thread Stefan Kamphausen
Hi Devin, On Thursday, August 4, 2011 5:14:19 AM UTC+2, Devin Walters (devn) wrote: On Jul 29, 2011, at 7:30 PM, Stefan Kamphausen wrote: inc IMHO there are three types of people coming to Clojure 1. Java Programmers 2. Old-school lispers 3. all the other, who just want to

Re: better community docs: getting started

2011-08-03 Thread Devin Walters
On Jul 29, 2011, at 7:30 PM, Stefan Kamphausen wrote: inc IMHO there are three types of people coming to Clojure Java Programmers Old-school lispers all the other, who just want to try (and possibly follow the examples in a tutorial or book) I humbly disagree. All of these groups

Re: better community docs: getting started

2011-07-30 Thread Laurent PETIT
2011/7/30 nchurch nchubr...@gmail.com But my question is : is it ready yet ? As a quick and simple way to get a REPL and edit code it seems to work fine. I added a sentence about its newness just so people would be aware of it... OK. I can really see it fill in the gaps, as I said

Re: better community docs: getting started

2011-07-29 Thread nchurch
Here's a tutorial on getting started with Clooj: http://dev.clojure.org/display/doc/getting+started+with+Clooj If this looks good to people, I'll try to get permission to reorganize the Getting Started docs a little. -- You received this message because you are subscribed to the Google Groups

Re: better community docs: getting started

2011-07-29 Thread Laurent PETIT
Sorry to make things look different than the apparent consensus of the participants to this thread, but isn't it a little bit too prematurate to put that pressure on Clooj ? I understand the desire to have Clooj for filling the gap. But my question is : is it ready yet ? 2011/7/29 nchurch

Re: better community docs: getting started

2011-07-29 Thread Ken Wesson
On Fri, Jul 29, 2011 at 5:33 PM, Laurent PETIT laurent.pe...@gmail.com wrote: Sorry to make things look different than the apparent consensus of the participants to this thread, but isn't it a little bit too prematurate to put that pressure on Clooj ? I understand the desire to have Clooj for

Re: better community docs: getting started

2011-07-29 Thread Lee Spector
On Jul 29, 2011, at 5:39 PM, Ken Wesson wrote: On Fri, Jul 29, 2011 at 5:33 PM, Laurent PETIT laurent.pe...@gmail.com wrote: Sorry to make things look different than the apparent consensus of the participants to this thread, but isn't it a little bit too prematurate to put that pressure on

Re: better community docs: getting started

2011-07-29 Thread Stefan Kamphausen
inc IMHO there are three types of people coming to Clojure 1. Java Programmers 2. Old-school lispers 3. all the other, who just want to try (and possibly follow the examples in a tutorial or book) For the first two groups the obstacles and interest can probably be sorted out and

Re: better community docs: getting started

2011-07-29 Thread nchurch
But my question is : is it ready yet ? As a quick and simple way to get a REPL and edit code it seems to work fine. I added a sentence about its newness just so people would be aware of it...if the author prefers no tutorial so far, then of course it should be taken down. -- You received

Re: better community docs: getting started

2011-07-28 Thread Bill Robertson
Hello Stu, I think the clear no options getting started path should include a tutorial and focus on the repl and using a *generic* text editor. A downloadable archive file (zip and tar) that included things like jline, clojure jars, and some scripts (.sh *and* .bat) to just start it would allow

Re: better community docs: getting started

2011-07-28 Thread Stefan Kamphausen
Hi, may I humbly suggest to come up with the most common user stories and put links to pages for those users right after the introductory paragraph. The typical scenarios will probably combine a few things, e.g. setting up maven and CCW. Further down the page the links to the detailed topics

Re: better community docs: getting started

2011-07-28 Thread uMany
I'm a total newbie with Clojure/Lisp/Java/Cake/Lein/Emacs etc. But I want to help translating to Spanish. If you tell me where can I find instructions to do it I will with pleasure. By the way, I've been fighting with Emacs/Clojure and everything else. It has been frustrating but I've learn a lot

Re: better community docs: getting started

2011-07-25 Thread Sean Corfield
On Sun, Jul 24, 2011 at 9:14 PM, Ken Wesson kwess...@gmail.com wrote: Under 2) would be a guide for setting up Emacs (immediately divided into Mac, Windows, Linux).  At the end would be a list of alternative options: Eclipse, Netbeans, IntelliJ, etc. No. No, no, no, no, no! That will kill

Re: better community docs: getting started

2011-07-25 Thread pmbauer
I do not think we should attempt a recommended IDE (not even Clooj). We should offer a path for all existing IDEs / editors. ... Use an editor not listed here? Try Clooj (i.e., use this as a simple catch-all if we haven't covered what you already used today). That's one way of

Re: better community docs: getting started

2011-07-25 Thread Ken Wesson
On Mon, Jul 25, 2011 at 12:28 AM, pmbauer paul.michael.ba...@gmail.com wrote: +1 on clooj. One click and you have a working build environment, REPL, and REPL-aware editor. https://github.com/downloads/arthuredelstein/clooj/clooj-0.1.5-standalone.jar This URL is somewhat unfortunate. For some

Re: better community docs: getting started

2011-07-25 Thread Ambrose Bonnaire-Sergeant
Yep, Github URLs suck like that. FWIW this is probably close what you're looking for: https://github.com/arthuredelstein/clooj/downloads Ambrose -- You received this message because you are subscribed to the Google Groups Clojure group. To post to this group, send email to

Re: better community docs: getting started

2011-07-25 Thread cljneo
ClojureScript release has changed things now and I guess that getting started with ClojureScript will probably change as it gets closer to a release. But anyway, I suggest a getting started page along these lines: * *Meet Clojure* - Try Clojure online http://try-clojure.org/ or on your

Re: better community docs: getting started

2011-07-25 Thread Mark Derricutt
I just thought - Java Webstart based clooj direct from try-clojure.org. Mark On 25/07/2011, at 6:51 PM, pmbauer wrote: For usability, nothing beats the single-click. In seconds, Clooj gives her a one-stop-shop. So I see Clooj as something worth putting right along with try-clojure.org. It

Re: better community docs: getting started

2011-07-25 Thread Sean Corfield
On Sun, Jul 24, 2011 at 11:51 PM, pmbauer paul.michael.ba...@gmail.com wrote: But think of the casual dev wanting to know what Clojure and a typical Clojure toolchain can do for her ASAP. I find it hard to imagine a casual dev that doesn't already have a preferred editor - but I'm certainly not

Re: better community docs: getting started

2011-07-25 Thread Mark Derricutt
I just thought - Java Webstart based clooj direct from try-clojure.org. On 25/07/2011, at 6:51 PM, pmbauer wrote: For usability, nothing beats the single-click. In seconds, Clooj gives her a one-stop-shop. So I see Clooj as something worth putting right along with try-clojure.org. It not

Re: better community docs: getting started

2011-07-25 Thread Michael Wood
On 25 July 2011 09:41, Sean Corfield seancorfi...@gmail.com wrote: On Sun, Jul 24, 2011 at 11:51 PM, pmbauer paul.michael.ba...@gmail.com wrote: [...] That's why I would give Clooj some prominence rather than burying it at the bottom of the decision tree. Well, then put it at the top with

Re: better community docs: getting started

2011-07-25 Thread abp
* *Meet Clojure* That's also an upcoming book on Clojure: http://meetclj.raynes.me/ -- 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

Re: better community docs: getting started

2011-07-25 Thread Mark Derricutt
I just thought - Java Webstart based clooj direct from try-clojure.org. On 25/07/2011, at 6:51 PM, pmbauer wrote: For usability, nothing beats the single-click. In seconds, Clooj gives her a one-stop-shop. So I see Clooj as something worth putting right along with try-clojure.org. It not

Re: better community docs: getting started

2011-07-25 Thread Lee Spector
On Jul 25, 2011, at 4:11 AM, Michael Wood wrote: On 25 July 2011 09:41, Sean Corfield seancorfi...@gmail.com wrote: On Sun, Jul 24, 2011 at 11:51 PM, pmbauer paul.michael.ba...@gmail.com wrote: [...] That's why I would give Clooj some prominence rather than burying it at the bottom of the

Re: better community docs: getting started

2011-07-25 Thread nchurch
How about making the main suggestion be clooj instead, with emacs, eclipse, netbeans in the list of alternative options? :) Sounds like consensus around Clooj. Released on July 18th, top option on July 25th! Things move at lightspeed around here The one thing I want to say about Emacs is

Re: better community docs: getting started

2011-07-25 Thread Sergey Didenko
IMO, it's a very good idea to give much more accent on the easiest options for newcomers. Other than not recommending Emacs, do people think that the overall organization I suggested is a good idea? I should reiterate that other information needs to be accessible; for now I'd just like to see

Re: better community docs: getting started

2011-07-25 Thread Sean Corfield
On Mon, Jul 25, 2011 at 9:03 AM, nchurch nchubr...@gmail.com wrote: Other than not recommending Emacs, do people think that the overall organization I suggested is a good idea? Yes. for now I'd just like to see us not presenting people with twelve options as their first view of Getting

Re: better community docs: getting started

2011-07-24 Thread nchurch
The community getting started page could be much better. In particular, people have opined that there should be a clear, no-choices- to-make path For Newbies section.Help welcome! I just got edit privileges on dev.clojure and am eager work on it. How do people want to see Getting Started on

Re: better community docs: getting started

2011-07-24 Thread Ken Wesson
On Sun, Jul 24, 2011 at 10:28 PM, nchurch nchubr...@gmail.com wrote: The community getting started page could be much better. In particular, people have opined that there should be a clear, no-choices- to-make path For Newbies section.Help welcome! I just got edit privileges on dev.clojure

Re: better community docs: getting started

2011-07-24 Thread László Török
+1, as I went through the same process. Emacs should be the option for the brave ones who already wrote their first helloworld.clj. sent from my mobile device On Jul 25, 2011 6:14 AM, Ken Wesson kwess...@gmail.com wrote: On Sun, Jul 24, 2011 at 10:28 PM, nchurch nchubr...@gmail.com wrote: The

Re: better community docs: getting started

2011-07-24 Thread Ambrose Bonnaire-Sergeant
On Mon, Jul 25, 2011 at 12:14 PM, Ken Wesson kwess...@gmail.com wrote: How about making the main suggestion be clooj instead, with emacs, eclipse, netbeans in the list of alternative options? :) +1! I'd be embarrassed trying to sell clojure to a newbie with anything else. Clean and simple,

Re: better community docs: getting started

2011-07-24 Thread pmbauer
+1 on clooj. One click and you have a working build environment, REPL, and REPL-aware editor. https://github.com/downloads/arthuredelstein/clooj/clooj-0.1.5-standalone.jar -- You received this message because you are subscribed to the Google Groups Clojure group. To post to this group, send

Re: better community docs: getting started

2011-07-23 Thread Sergey Didenko
I checked the great manual 113 Design Guidelines for Homepage Usability from Jakob Nielsen and here are my thoughts about the main page (clojure.org ): 1) It's misleading that some links in the left pane are underlined (API, Recent changes, Libraries, Community) while others are not. 2) It's

better community docs: getting started

2011-07-22 Thread Stuart Halloway
I am working through a few of the pages on clojure.org with two goals: (1) remove or fix anything that is outdated or incorrect (2) move to the community site (dev.clojure.org) things that should be maintained by the community. As a first pass, I have trimmed

Re: better community docs: getting started

2011-07-22 Thread Aaron Cohen
On Fri, Jul 22, 2011 at 5:22 PM, Stuart Halloway stuart.hallo...@gmail.comwrote: I am working through a few of the pages on clojure.org with two goals: (1) remove or fix anything that is outdated or incorrect I really like how minimal that is now. A quick suggestion: shouldn't the Copyright

Re: better community docs: getting started

2011-07-22 Thread Stuart Halloway
I am working through a few of the pages on clojure.org with two goals: (1) remove or fix anything that is outdated or incorrect I really like how minimal that is now. A quick suggestion: shouldn't the Copyright date be updated too? Yuo. Fixed, thanks. Stu Stuart Halloway

Re: better community docs: getting started

2011-07-22 Thread Phil Hagelberg
Stuart Halloway stuart.hallo...@gmail.com writes: As a first pass, I have trimmed http://clojure.org/getting_started, and quite clearly linked out to http://dev.clojure.org/display/doc/Getting+Started for advice on tools, IDEs, etc. That's a huge improvement; glad to see it finally getting

Re: better community docs: getting started

2011-07-22 Thread Alan Malloy
On Jul 22, 3:32 pm, Phil Hagelberg p...@hagelb.org wrote: Stuart Halloway stuart.hallo...@gmail.com writes: As a first pass, I have trimmedhttp://clojure.org/getting_started, and quite clearly linked out tohttp://dev.clojure.org/display/doc/Getting+Startedfor advice on tools, IDEs, etc.

Re: better community docs: getting started

2011-07-22 Thread Sean Corfield
On Fri, Jul 22, 2011 at 2:22 PM, Stuart Halloway stuart.hallo...@gmail.com wrote: I am working through a few of the pages on clojure.org with two goals: (1) remove or fix anything that is outdated or incorrect (2) move to the community site (dev.clojure.org) things that should be maintained by

Re: better community docs: getting started

2011-07-22 Thread Stuart Halloway
I am working through a few of the pages on clojure.org with two goals: (1) remove or fix anything that is outdated or incorrect (2) move to the community site (dev.clojure.org) things that should be maintained by the community. As a first pass, I have trimmed