I'd like to say that as a Clojure programmer I really like the current page.
The reference documentation is an excellent resource. It does not answer all questions, but it answers the most critical ones very concisely and I hope that you intend to keep it like that. If one thing about the page could be done better it is its appearance towards people who heard about Clojure the first time and want to learn more about it. I think I learned about Clojure back ago when researching something Lisp related and in that context listened to a Rich Hickey talk. I thought: He created a programming language? It must either be insanely great or idealistic but unpractical. I went to the clojure.org website and thought: Oh, so he created the website for it as well (I think that is not true but that is what I thought), concluded that the language can't be very popular and probably does not have many users. It immediately ranked lower on the list of languages I wanted to try out. That was around 2012. The page failed to make me want to try out Clojure immediately mostly because it didn't make me trust in it on first sight. Listing high profile companies that are using Clojure might help. If I remember correctly, it was a few weeks later when out of curiosity I opened the Youtube video "Clojure for Lisp programmers" that made me want to try out Clojure. There is also one "Clojure for Java programmers" and "Clojure Data structures" on ClojureTV. I think these should be put on the front page and be one click away. A 5 minute tutorial, probably with an in-browser REPL like tryclj.com should also be one click away. On a side note, "Clojure data structures" could be redone for the web as audience and enhanced with some visualization directed towards people who have no idea how immutable DS in a Lisp "feel". Kind regards, Leon. On Thursday, November 12, 2015 at 11:58:41 AM UTC+1, Nando Breiter wrote: > > Expanding on the content idea for new-comers *to Clojure*, like me, (but > not necessarily to programming in general), I've found the approachs taken > by Living Clojure and PurelyFunctional.tv to be really helpful. Both Carin > Meier and Eric Normand (for example) take a relatively shallow angle of > attack and yet maintain an engaging pace, focusing on key areas of the > language. They lay out a *path* to learn, and invite the new-comer to > follow along. Not everyone might need tutoring like this, but judging from > the recommendations I've seen, others seem to appreciate it. > > The Getting Started page is currently a list of resources. That's > certainly needed. But it can take someone new to Clojure a considerable > amount of time to dive into all of it. And it's easy to get bogged down. > While there may be value in letting folks sort it out and slog through it > all for themselves, there's no learning path laid out on the website. Hence > I think a dedicated page or section named, for instance, "How to learn > Clojure" might be helpful. > > What should go in this section? Content that would help someone having at > least some difficulty learning Clojure. Content that would help them sort > out how to approach learning the language. Content that would help them > prioritize which resources to use at which level. > > > > > > > > Aria Media Sagl > Via Rompada 40 > 6987 Caslano > Switzerland > > +41 (0)91 600 9601 > +41 (0)76 303 4477 cell > skype: ariamedia > > On Wed, Nov 11, 2015 at 9:24 PM, Harrison Maseko <lis...@gmail.com > <javascript:>> wrote: > >> Content idea: Would be nice to have a section for new-comers to >> programming, introducing them to programming through Clojure. All of the >> existing Clojure books that I know of are aimed at those with intermediate >> to advanced programming skills in Clojure or another language. The content >> and learning gradient in those books can be steep and could put off a >> beginner. Although Clojure is such an advanced language, I think it's >> possible to implant programming concepts in a complete beginner by using a >> subset of Clojure. But maybe the the clojure.org Website is not the >> right place for that? >> Thanks, >> H >> >> >> On Tuesday, November 10, 2015 at 5:57:45 PM UTC+2, Alex Miller wrote: >>> >>> Hi Hildeberto, >>> >>> I built spikes of the site in a number of technologies like Cryogen, >>> Stasis, Sphinx, Asciidoctor, and some of the other Ruby-based static >>> generators as well. In the end, I found that JBake was the best match for >>> our goals at this time. The site build architecture has been decided and >>> we're not interested in revisiting that at this time. At some point down >>> the road, based on experience and tool evolution, we may take another look, >>> but not soon. >>> >>> Cryogen is a great tool and I would recommend it to others. One problem >>> I had with it was its flexibility with respect to the url structure. I >>> actually think for the purposes of creating a blog etc that is a dimension >>> that is good to remove, but it was a downside for our use. >>> >>> We are working with a designer on the site look and feel and at some >>> point that will be visible. At the point where that is visible, I expect >>> there will be some evolution on front page, navigation structure, etc and >>> would be happy to get feedback on that. >>> >>> Right now, we are primarily looking for content ideas and would love >>> thoughts on that. Or if there is interest in enhancing existing pages, I >>> would also like to talk about those. >>> >>> Thanks, >>> Alex >>> >>> >>> >>> On Tuesday, November 10, 2015 at 9:41:40 AM UTC-6, Hildeberto Mendonça >>> wrote: >>>> >>>> That's a great initiative! Thanks! But I'm just sad to see JBake >>>> instead of Cryogen (https://github.com/cryogen-project/cryogen-core) >>>> which is written in Clojure :-( Can we send a pull request replacing JBake >>>> by Cryogen or is JBake a final decision? >>>> >>>> -- >>>> Hildeberto Mendonça, Ph.D >>>> Blog: http://www.hildeberto.com >>>> Twitter: https://twitter.com/htmfilho >>>> >>> -- >> You received this message because you are subscribed to the Google >> Groups "Clojure" group. >> To post to this group, send email to clo...@googlegroups.com >> <javascript:> >> Note that posts from new members are moderated - please be patient with >> your first post. >> To unsubscribe from this group, send email to >> clojure+u...@googlegroups.com <javascript:> >> For more options, visit this group at >> http://groups.google.com/group/clojure?hl=en >> --- >> You received this message because you are subscribed to the Google Groups >> "Clojure" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to clojure+u...@googlegroups.com <javascript:>. >> For more options, visit https://groups.google.com/d/optout. >> > > -- 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 be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.