Re: [ANN] Let's make clojure.org better!

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

Re: [ANN] Let's make clojure.org better!

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

Re: [ANN] Let's make clojure.org better!

Yes, all of the instructions point you to a stable build of JBake 2.5.0-SNAPSHOT. There is, in particular, a fix coming in 2.5.0 that allows us to output files with no extension so that urls look like http://clojure.org/reader instead of http://clojure.org/reader.html. When 2.5 is released,

Re: [ANN] Let's make clojure.org better!

Is there a list of reviewers and editors? On Tue, Nov 10, 2015 at 9:14 AM, Alex Miller wrote: > The Clojure community is full of talented writers and valuable experience, > and together we can create great documentation for the language and the > ecosystem. With that in

Re: [ANN] Let's make clojure.org better!

All set here! Just to point out that the site generation didn't work with JBake v2.4.0 (latest stable). So, if you already use JBake, you will have to upgrade it to v2.5.0-SNAPSHOT, as suggested in the README file. On Wed, Nov 11, 2015 at 5:38 AM, Dmitri wrote: > Just

Re: [ANN] Let's make clojure.org better!

I don’t know how feasible that is as a tool lives in a much smaller space than everything you can do with that tool. “programming through Clojure” feels a bit like teaching Carpentry through examine a hammer… On the other hand, do I think the Clojure community have some excellent ideas on how

Re: [ANN] Let's make clojure.org better!

On Wednesday, November 11, 2015 at 10:27:34 AM UTC-6, Nelson Morris wrote: > > Is there a list of reviewers and editors? > In the interest of getting this public, I did not wait to figure out all the details of the review and editing process before we made the announcement. I am hoping to get a

Re: [ANN] Let's make clojure.org better!

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

Re: [ANN] Let's make clojure.org better!

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? On Tue, Nov 10, 2015 at 4:14 PM, Alex Miller

Re: [ANN] Let's make clojure.org better!

Thanks for clarifying that Alex. On Tue, Nov 10, 2015 at 4:57 PM, 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

Re: [ANN] Let's make clojure.org better!

On 10 Nov 2015, at 15:14, Alex Miller wrote: > The Clojure community is full of talented writers and valuable experience, > and together we can create great documentation for the language and the > ecosystem. With that in mind, we are happy to announce a new initiative to

Re: [ANN] Let's make clojure.org better!

Link was bad - sorry! https://github.com/clojure/clojure-site/blob/master/content/community/contributing_site.adoc On Tuesday, November 10, 2015 at 10:45:59 AM UTC-6, Alan Forrester wrote: > > The site contribution page does not seem to be up. > > > Alan > -- You received this message because

[ANN] Let's make clojure.org better!

The Clojure community is full of talented writers and valuable experience, and together we can create great documentation for the language and the ecosystem. With that in mind, we are happy to announce a new initiative to replace the existing http://clojure.org site. The new site will contain

Re: [ANN] Let's make clojure.org better!

A better link about Cryogen: http://cryogenweb.org On Tue, Nov 10, 2015 at 4:41 PM, 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

Re: [ANN] Let's make clojure.org better!

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

Re: [ANN] Let's make clojure.org better!

Just a note that the author of Cryogen is very responsive regarding discussions on improvements and pull requests for additional functionality. If there's a particular feature that's missing it might be worth creating an issue or opening a pr for it. On Tuesday, November 10, 2015 at 10:57:45