Re: better community docs: getting started

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

Re: better community docs: getting started

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 grou

Re: better community docs: getting started

2011/7/30 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... OK. I can really see it fill in the gaps, as I said above, it has inde

Re: better community docs: getting started

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

Re: better community docs: getting started

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 t

Re: better community docs: getting started

On Jul 29, 2011, at 5:39 PM, Ken Wesson wrote: > On Fri, Jul 29, 2011 at 5:33 PM, Laurent PETIT > 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 un

Re: better community docs: getting started

On Fri, Jul 29, 2011 at 5:33 PM, Laurent PETIT 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 "filling the gap". >

Re: better community docs: getting started

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

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

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

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

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

On Mon, Jul 25, 2011 at 9:03 AM, nchurch 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 Started, all in lin

Re: better community docs: getting started

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

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

Re: better community docs: getting started

On Jul 25, 2011, at 4:11 AM, Michael Wood wrote: > On 25 July 2011 09:41, Sean Corfield wrote: >> On Sun, Jul 24, 2011 at 11:51 PM, pmbauer >> wrote: > [...] >>> That's why I would give Clooj some prominence rather than burying it at the >>> bottom of the decision tree. >> >> Well, then put i

Re: better community docs: getting started

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

Re: better community docs: getting started

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

Re: better community docs: getting started

On 25 July 2011 09:41, Sean Corfield wrote: > On Sun, Jul 24, 2011 at 11:51 PM, pmbauer > 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 the tag line "If you don't have a > strong a

Re: better community docs: getting started

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

Re: better community docs: getting started

On Sun, Jul 24, 2011 at 11:51 PM, pmbauer 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 averse to promoting Cloo

Re: better community docs: getting started

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

Re: better community docs: getting started

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 or on your mac

Re: better community docs: getting started

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 clojure@googlegroup

Re: better community docs: getting started

On Mon, Jul 25, 2011 at 12:28 AM, pmbauer 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 reason, both https://git

Re: better community docs: getting started

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

On Sun, Jul 24, 2011 at 9:14 PM, Ken Wesson 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 90% of

Re: better community docs: getting started

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

Re: better community docs: getting started

On Mon, Jul 25, 2011 at 12:14 PM, Ken Wesson 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, and not a toy.

Re: better community docs: getting started

+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" wrote: > On Sun, Jul 24, 2011 at 10:28 PM, nchurch wrote: >> >>> The community getting started pag

Re: better community docs: getting started

On Sun, Jul 24, 2011 at 10:28 PM, nchurch 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 and am ea

Re: better community docs: getting started

> 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

Re: better community docs: getting started

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)

Re: better community docs: getting started

>> 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 http://clojure.org/getti

Re: better community docs: getting started

On Fri, Jul 22, 2011 at 2:22 PM, Stuart Halloway 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 the community. > As a

Re: better community docs: getting started

On Jul 22, 3:32 pm, Phil Hagelberg wrote: > Stuart Halloway 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. > > That's a huge improvement; glad t

Re: better community docs: getting started

Stuart Halloway 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 some attention. I have h

Re: better community docs: getting started

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

Re: better community docs: getting started

On Fri, Jul 22, 2011 at 5:22 PM, Stuart Halloway 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 > > I really like how minimal that is now. A quick suggestion: shouldn't the Copyright date be updated too?

better community docs: getting started

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 http://clojure.org/getting_started,