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

[Leon Grapenthin]

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

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

[Nando Breiter]

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

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

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

[Alex Miller]

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, I'll change the instructions to point to the stable 
release instead.

The build instructions on the site may change periodically, but the 
instructions should always be up to date there.


On Wednesday, November 11, 2015 at 8:08:33 AM UTC-6, Hildeberto Mendonça 
wrote:
>
> 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.
>
>

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

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

[Nelson Morris]

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 mind, we are happy to announce a new initiative to
> replace the existing http://clojure.org site. The new site will contain
> most of the existing reference and information content but will also
> provide an opportunity for additional guides or tutorials about Clojure and
> its ecosystem.
>
> The new site content is hosted in a GitHub repository
>  and is open for contributions.
> All contributions require a signed Clojure Contributor Agreement. This
> repository will accept contributions via pull request and issues with
> GitHub issues. The contribution and review process is described in more
> detail on the site contribution
> 
> page.
>
> We are currently working on the design elements for the site but if you
> would like to suggest a new guide, tutorial, or other content to be
> included on the site, please file an issue
>  for discussion or create
> a thread on the Clojure mailing list
>  with [DOCS] in the subject.
> There will be an unsession at the Clojure/conj 
> conference next week for additional discussion. This is the beginning of a
> process, and things will likely evolve in the future. In the meantime, we
> look forward to seeing your contributions!
>
> --
> 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.
>

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

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

[Hildeberto Mendonça]

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 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 AM UTC-5, 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 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.
>



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

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

[Colin Yates]

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 to program - absolutely. Most of the value I find from the various 
Clojure related videos are nothing to do with Clojure per-sa but to do with 
programming. Complicating, simple v easy and so on.

I do think there would be much value in a page of programming related resources 
that the community consider are ‘good’ but I am not sure that is the same set 
of resources as “I don’t know how to program, how do I learn”…

I wonder whether a related page of “how Clojure helped upgrade my programming” 
might be valuable...

> On 11 Nov 2015, at 20:24, Harrison Maseko  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 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 
> .

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

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

[Alex Miller]

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 feel for volume and workload as we get 
going too to inform the process. For the moment, I will serve as the 
reviewer for all submissions. Rich will serve as editor for the reference 
portions of the content and I will serve as editor for the rest.

Over time these lists will expand and include people both inside and 
outside Cognitect.


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

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

[Harrison Maseko]

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

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

[Hildeberto Mendonça]

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  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
> replace the existing http://clojure.org site. The new site will contain
> most of the existing reference and information content but will also
> provide an opportunity for additional guides or tutorials about Clojure and
> its ecosystem.
>
> The new site content is hosted in a GitHub repository
>  and is open for contributions.
> All contributions require a signed Clojure Contributor Agreement. This
> repository will accept contributions via pull request and issues with
> GitHub issues. The contribution and review process is described in more
> detail on the site contribution
> 
> page.
>
> We are currently working on the design elements for the site but if you
> would like to suggest a new guide, tutorial, or other content to be
> included on the site, please file an issue
>  for discussion or create
> a thread on the Clojure mailing list
>  with [DOCS] in the subject.
> There will be an unsession at the Clojure/conj 
> conference next week for additional discussion. This is the beginning of a
> process, and things will likely evolve in the future. In the meantime, we
> look forward to seeing your contributions!
>
> --
> 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.
>



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

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

[Hildeberto Mendonça]

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



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

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

['Alan Forrester' via Clojure]

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 
> replace the existing http://clojure.org  site. The new 
> site will contain most of the existing reference and information content but 
> will also provide an opportunity for additional guides or tutorials about 
> Clojure and its ecosystem. 
> 
> The new site content is hosted in a GitHub repository 
>  and is open for contributions. All 
> contributions require a signed Clojure Contributor Agreement. This repository 
> will accept contributions via pull request and issues with GitHub issues. The 
> contribution and review process is described in more detail on the site 
> contribution 
> 
>  page. 

The site contribution page does not seem to be up.

Alan

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

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

[Alex Miller]

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

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

[Alex Miller]

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 
most of the existing reference and information content but will also 
provide an opportunity for additional guides or tutorials about Clojure and 
its ecosystem. 

The new site content is hosted in a GitHub repository 
 and is open for contributions. 
All contributions require a signed Clojure Contributor Agreement. This 
repository will accept contributions via pull request and issues with 
GitHub issues. The contribution and review process is described in more 
detail on the site contribution 

 
page. 

We are currently working on the design elements for the site but if you 
would like to suggest a new guide, tutorial, or other content to be 
included on the site, please file an issue 
 for discussion or create a 
thread on the Clojure mailing list  
with [DOCS] in the subject. There will be an unsession at the Clojure/conj 
 conference next week for additional discussion. 
This is the beginning of a process, and things will likely evolve in the 
future. In the meantime, we look forward to seeing your contributions!

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

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

[Hildeberto Mendonça]

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 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  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 replace the existing http://clojure.org site. The new site
>> will contain most of the existing reference and information content but
>> will also provide an opportunity for additional guides or tutorials about
>> Clojure and its ecosystem.
>>
>> The new site content is hosted in a GitHub repository
>>  and is open for contributions.
>> All contributions require a signed Clojure Contributor Agreement. This
>> repository will accept contributions via pull request and issues with
>> GitHub issues. The contribution and review process is described in more
>> detail on the site contribution
>> 
>> page.
>>
>> We are currently working on the design elements for the site but if you
>> would like to suggest a new guide, tutorial, or other content to be
>> included on the site, please file an issue
>>  for discussion or
>> create a thread on the Clojure mailing list
>>  with [DOCS] in the subject.
>> There will be an unsession at the Clojure/conj 
>> conference next week for additional discussion. This is the beginning of a
>> process, and things will likely evolve in the future. In the meantime, we
>> look forward to seeing your contributions!
>>
>> --
>> 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.
>>
>
>
>
> --
> Hildeberto Mendonça, Ph.D
> Blog: http://www.hildeberto.com
> Twitter: https://twitter.com/htmfilho
>



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

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

[Alex Miller]

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

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

[Dmitri]

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 AM UTC-5, 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 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.