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 wrote: > On Fri, Oct 5, 2012 at 12:58 AM, Michael 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

Re: Regarding Starting Clojure

2012-10-04 Thread Mayank Jain
On Fri, Oct 5, 2012 at 12:58 AM, Michael 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. > > https://github.com/fogus/www-readevalprintlove-org > Awesome! So beautiful! I can just kee

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 wrote: > lol, That is

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

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-03 Thread Shantanu Kumar
On Oct 3, 8:42 pm, Grant Rettke 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 to be a > lab

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

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

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 behind

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-01 Thread nchurch
To cite some concrete examples: "Datomic" 0 hits on Clojure.org "Clojurescript" 1 hit On Oct 1, 11:09 pm, nchurch 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 noticed, and t

Re: Regarding Starting Clojure

2012-10-01 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 options

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

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 commu

Re: Regarding Starting Clojure

2012-10-01 Thread Grant Rettke
On Mon, Oct 1, 2012 at 4:13 PM, aboy021 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 the > Clojure communi

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 prom