I think another useful way to look at the issue that Alan brings up is to view it as a top down vs bottom up approach to learning the language. The site favors a top down approach, leading with the rationale and concepts rather than examples that can act like hooks that encourage the reader to investigate further even without complete understanding. While I'm more of a default top down thinker myself, I know and respect many bottom up thinkers. I believe enhancing the website to address both learning approaches will increase its usability not to just beginners but also to experienced programmers.
On Friday, January 15, 2016 at 7:16:08 PM UTC-5, Alan Moore wrote: > > Great job everyone! I really like the layout and the color scheme, very > pleasing to the eye and professional looking. > > My *only* constructive comment is that a total newbie landing on > clojure.org is faced with a lot of reading when maybe they should be > presented with super basic code examples, just to give them a general feel > of what Clojure code looks like. Much of this does exist on the site but is > maybe less accessible and not as up-front as it could be. I'll submit some > suggestions via the public repo and do my part to help out :-) > > All in all this is looking great and I appreciate the hard work in getting > it to this point. Thanks Alex for organizing the effort! > > Alan > > On Thursday, January 14, 2016 at 7:45:06 AM UTC-8, Alex Miller wrote: >> >> The new http://clojure.org is alive! >> >> Most of the content on the site is the same content as before (but in a >> new shinier package). However, the site is now sourced from the public repo >> at https://github.com/clojure/clojure-site and is open for contribution. >> Contributions (via pull request) require a signed Clojure Contributor >> Agreement, just as with Clojure itself - if you've already signed it, then >> you don't need to do anything additional. >> >> We have been working on several new guides for the new Guides section and >> you can see things in process at >> https://github.com/clojure/clojure-site/issues - feel free to discuss on >> issues there or threads here with a [DOC] indicator. Or on the #docs >> channel on Slack. >> >> Big thanks to Tom Hickey on the design for the new site! As always, he >> was a pleasure to work with. >> >> Alex >> > -- 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.
