Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-11 Thread Laurent PETIT
I'm very excited about this. As has been said before, all skills aren't located in the same person, and someone with ability to develop does not necessarily have the competence, the guts, or the time to write great end user documentation. So I'm high five for this project, especially because

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-11 Thread gaz jones
I have 3 blog posts I wrote to help some colleagues get up to speed with clojure / emacs: http://blog.gaz-jones.com/2012/02/01/setting_up_emacs_for_clojure_development.html http://blog.gaz-jones.com/2012/02/02/clojure_development_cycle.html

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-11 Thread Grant Rettke
On Thu, Oct 11, 2012 at 12:50 PM, gaz jones gareth.e.jo...@gmail.com wrote: I have 3 blog posts I wrote to help some colleagues get up to speed with clojure / emacs: Looks great. You never know what is the best thing for everyone, so what works for you will probably work for others, too. --

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-11 Thread Michael Klishin
2012/10/11 gaz jones gareth.e.jo...@gmail.com They are all based on Emacs 24, leiningen 1.x, and swank-clojure. Is there any appetite for me to convert / update them and merge them into CDS under the tutorials section? I have been told by a few people that they found them useful and I tried

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-11 Thread gaz jones
Alright, I'll convert the appropriate ones and send you a pull request when I'm done. I'm happy to pick up writing a tools.cli tutorial too when I get some spare time. Thanks for kickstarting the effort, it's shaping up to be a great resource. -- You received this message because you are

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-11 Thread Murphy McMahon
I'm not really enough of an authority to contribute much at this point, but I wanted to take a second, as someone who has been learning Clojure (and Emacs) over the past year or so, to applaud the effort and share my opinion: I really like something like this: https://gobyexample.com/ It is

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-10 Thread Andrew Brehaut
On Tuesday, October 9, 2012 5:26:23 AM UTC+13, Michael Klishin wrote: … * Do not copy content from blog posts unless you are the author … I wrote a brief introduction to web development in clojure[1] last year. If anyone wants to use it as part of or a basis for an article about web dev

[OT] Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-10 Thread Roberto Mannai
I'm pretty sure you have already thought about it and it's me that missed your considerations, but why we are not using a wiki-based tool, like Wordpress, instead of forking a git branch? On Mon, Oct 8, 2012 at 6:25 PM, Michael Klishin michael.s.klis...@gmail.com wrote: ## Announcing

Re: [OT] Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-10 Thread John Gabriele
On Wednesday, October 10, 2012 6:38:31 PM UTC-4, robermann79 wrote: I'm pretty sure you have already thought about it and it's me that missed your considerations, but why we are not using a wiki-based tool, like Wordpress, instead of forking a git branch? My original goals for CDS were to

Re: [OT] Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-10 Thread Michael Klishin
robermann79: I'm pretty sure you have already thought about it and it's me that missed your considerations, but why we are not using a wiki-based tool, like Wordpress, instead of forking a git branch? * Developers prefer writing docs and code examples in their favorite editor and not a

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-09 Thread Brent Millare
As a start for my contributions, I want to open up some topics for discussion. 1. Front Page Design Currently, it looks like the front page has a bunch of miniature slides. Do we want the front page to mainly be the focus of advertisement and have a separate navigation system (aka see all

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-09 Thread Michael Klishin
2012/10/9 Brent Millare brent.mill...@gmail.com 1. Front Page Design Currently, it looks like the front page has a bunch of miniature slides. Do we want the front page to mainly be the focus of advertisement and have a separate navigation system (aka see all contents)? Or do we want

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-08 Thread nchurch
Quick question: would it be possible to copy stuff from dev.clojure.org? I wrote some stuff over there, under the CA agreement, but it's kind of a wiki format so it might be unclear who 'owns' it. BTW, I noticed the front page of clojure.org got its headings cleaned upthank you to whoever

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-08 Thread John Gabriele
On Monday, October 8, 2012 12:26:23 PM UTC-4, Michael Klishin wrote: ## Announcing clojure-doc.org I am starting a new thread because the existing one about CDS is now polluted by all kinds of off-topics. About a week ago, John Gabrielle Just one ell. :) announced CDS (Clojure

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-08 Thread Michael Klishin
2012/10/8 Laurent PETIT laurent.pe...@gmail.com By signing the CA agreement you did not give away your copyright on stuff you made, so I think it's ok for you to copy what *you* wrote there. This is my understanding as well but I am not a lawyer. Content from clojure.org won't be merged for

Re: ANN clojure-doc.org (aka CDS), a new community-driven Clojure documentation site

2012-10-08 Thread Dave Della Costa
Hi John, regarding the backticks for code blocks, are you talking about using Markdown? It looks like because Jekyll uses the markdown parser Maruku (http://maruku.rubyforge.org/maruku.html), instead of the redcarpet that GFM uses, you'll have to use tildes instead of backticks. Dave