Re: Regarding Starting Clojure

2012-10-04 Thread Michael Fogus
Here's one approach: Make a github of the code and content that runs the site. People fork and make pull requests. You talked me into it. https://github.com/fogus/www-readevalprintlove-org -- You received this message because you are subscribed to the Google Groups Clojure group. To post to

Re: Regarding Starting Clojure

2012-10-04 Thread Brent Millare
lol, That is really awesome! I'm going to have to really read through the sources now. On Thursday, October 4, 2012 3:28:41 PM UTC-4, Fogus wrote: Here's one approach: Make a github of the code and content that runs the site. People fork and make pull requests. You talked me into it.

Re: Regarding Starting Clojure

2012-10-04 Thread Grant Rettke
I loved Mathematica's documentation that had lovingly maintained by... in the sidebar or something to that effect. It was really apparent that the maintainer did lovingly maintain it. Can't seem to find it at the moment though. On Thu, Oct 4, 2012 at 2:49 PM, Brent Millare brent.mill...@gmail.com

Re: Regarding Starting Clojure

2012-10-04 Thread Mayank Jain
On Fri, Oct 5, 2012 at 12:58 AM, Michael Fogus mefo...@gmail.com wrote: Here's one approach: Make a github of the code and content that runs the site. People fork and make pull requests. You talked me into it. https://github.com/fogus/www-readevalprintlove-org Awesome! So beautiful! I

Re: Regarding Starting Clojure

2012-10-04 Thread nchurch
Thanks guys! (And also to the other announcement.) On Oct 4, 2:07 pm, Mayank Jain firesof...@gmail.com wrote: On Fri, Oct 5, 2012 at 12:58 AM, Michael Fogus mefo...@gmail.com wrote: Here's one approach: Make a github of the code and content that runs the site. People fork and make pull

Re: Regarding Starting Clojure

2012-10-03 Thread aboy021
The general feeling seems to be that there is good content out there, but it would be nice if it were on Clojure.org, especially from the perspective of new users and promoting the language. The copyright on the site is to Rich Hickey, and the logo and site design are credited to Tom Hickey.

Re: Regarding Starting Clojure

2012-10-03 Thread Grant Rettke
You guys are over-thinking it. Set up a new site, get users, tweak it, perfect it, it will become the defacto site, and you will make it really easy for Rich et al to make the switch :). It may take loads of hard and unappreciated labor though :(. That is why it has to be a labor of love. On Wed,

Re: Regarding Starting Clojure

2012-10-03 Thread Shantanu Kumar
On Oct 3, 8:42 pm, Grant Rettke gret...@acm.org wrote: Set up a new site, get users, tweak it, perfect it, it will become the defacto site, and you will make it really easy for Rich et al to make the switch :). It may take loads of hard and unappreciated labor though :(. That is why it has

Re: Regarding Starting Clojure

2012-10-03 Thread Brent Millare
What's the best way to allow collaborative contribution on content that must be agreed upon? Here's one approach: Make a github of the code and content that runs the site. People fork and make pull requests. -- You received this message because you are subscribed to the Google Groups Clojure

Re: Regarding Starting Clojure

2012-10-02 Thread nchurch
I put together the Getting Started confluence page. I'm sure it could still be improved, but adding further to it won't really fix the problems you've noticed, and that many other people have noted. It's still on a secondary site, and Confluence doesn't really give you a lot of design

Re: Regarding Starting Clojure

2012-10-02 Thread nchurch
To cite some concrete examples: Datomic 0 hits on Clojure.org Clojurescript 1 hit On Oct 1, 11:09 pm, nchurch nchubr...@gmail.com wrote: I put together the Getting Started confluence page.  I'm sure it could still be improved, but adding further to it won't really fix the problems you've

Re: Regarding Starting Clojure

2012-10-02 Thread nchurch
I should clarify that the issue with Clojure.org isn't really \design, per seit's the choice of what to present on what level. Scala gives you pointers for what you need to know, right away at the top: About Scala, Documentation, Code Examples, Software, Scala Developers. Whereas Clojure has

Re: Regarding Starting Clojure

2012-10-02 Thread Yakovlev Roman
You can make your site with many examples and good documentation and maybe it will be at first place at google if it will have great value. A lot of people here will agree with that. Site could be better place to get started ! but old site still there. As far as i know there is a company

Re: Regarding Starting Clojure

2012-10-02 Thread nchurch
Clojuredocs is already out there and quite good (though not modified much as of late). However, it doesn't show up very high on Google (not even on the first page for Clojure). There's also Learn Clojure, which has a clean design but hasn't been updated in a while (and also doesn't seem to have

Regarding Starting Clojure

2012-10-01 Thread aboy021
I decided to quickly compare the website experience of starting Clojure and starting Scala. I do a Google search for Clojure I decide to try the first link, Clojure.org There's some basic information. I follow the somewhat obscure link halfway down the side, Getting Started Ok, that looks

Re: Regarding Starting Clojure

2012-10-01 Thread Grant Rettke
On Mon, Oct 1, 2012 at 4:13 PM, aboy021 arthur.bo...@gmail.com wrote: The getting started issue is an ongoing problem for Clojure. It's an issue that keeps coming up in the surveys and on the mailing list. Other languages are doing it really well, Scala is just a convenient example. What does

Re: Regarding Starting Clojure

2012-10-01 Thread Andreas Liljeqvist
Probably they wouldn't, but that's not the point. The clojure community is doing something wrong for providing a coherent beginner experience. Maybe we aren't good at encouraging people to contribute documentation. Or the composability of Clojure leads to small library islands without much

Re: Regarding Starting Clojure

2012-10-01 Thread Brent Millare
Sounds like the main beef is with the official website's styling and layout. I agree its not necessarily the prettiest but all the information is there. On the other hand, there are plenty of great resources that provide a great getting started experience in my opinion. Just typing clojure in