Re: ANN: a Clojure docs site, and github organization

2012-10-10 Thread Andy Fingerhut
Michael, thanks for the detailed response, and I appreciate the effort you are putting forth in the clojure-doc.org site. I do have some followup questions on clojuredocs.org, since you gave some description of what you hope and/or expect to happen there. On Oct 5, 2012, at 1:52 PM, Michael

Re: ANN: a Clojure docs site, and github organization

2012-10-10 Thread Michael Klishin
2012/10/10 Andy Fingerhut andy.finger...@gmail.com *Whose* goal is it to make those changes to clojuredocs.org? Someone that is willing and able to write the code, has the time to do it, and is authorized to make changes to the clojuredocs.org site? I ask not because I expect anyone to make

Re: ANN: a Clojure docs site, and github organization

2012-10-10 Thread Lee Hinman
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Andy, On 10/10/12 1:30 PM, Andy Fingerhut wrote: Michael, thanks for the detailed response, and I appreciate the effort you are putting forth in the clojure-doc.org http://clojure-doc.org site. I do have some followup questions on

Re: ANN: a Clojure docs site, and github organization

2012-10-08 Thread Bill Robertson
Giant +1 to moving clojuredocs.org forward. I've been getting concerned about the longevity of the site, and I would really miss it if it were gone. On Thursday, October 4, 2012 4:35:33 PM UTC-4, Michael Klishin wrote: 2012/10/5 Bronsa brob...@gmail.com javascript: Wouldn't it be better for

Re: ANN: a Clojure docs site, and github organization

2012-10-07 Thread nchurch
Just to keep in touch with our marvelous legal systems in North America, read this: ... how much I am frustrated by this shattered world Indeed! The law is nothing but an overly complex, haphazardly designed, historically encrufted programming language for morals. Its compiler is

Re: ANN: a Clojure docs site, and github organization

2012-10-07 Thread gaz jones
While on this topic, is it possible for someone with admin privileges to disable the Issues tabs in the contrib projects? There is a consistent drip of people sending pull requests or opening bugs which have to be redirected to JIRA. All of the contrib projects now point to JIRA in the README for

Re: ANN: a Clojure docs site, and github organization

2012-10-07 Thread John Gabriele
On Sunday, October 7, 2012 9:32:45 PM UTC-4, Gaz wrote: While on this topic, is it possible for someone with admin privileges to disable the Issues tabs in the contrib projects? There is a consistent drip of people sending pull requests or opening bugs which have to be redirected to JIRA.

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread aboy021
+1 to lowering the barrier to entry for contributing to the community. One of the much lauded features of Git is that it can be used to create a network of trust. In principle this means you can open your repo up to anyone, but by being choosy about the pull requests you accept you can control

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Softaddicts
This insistence on the so-called CA pain seems to me overemphasized. It's a one shot process. Even if it takes 4 weeks for the paper to reach its destination, it does not prevent anyone from starting to work on some contribution. The CA needs to be in by the time the work is about to get

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Jay Fields
The CA process isn't what stops me from contributing, the post a patch to Jira is what seems broken to me. I don't even remember how to create a patch. Clojure is on github - we live in a fork pull request world, it's time for Clojure to get on board with that. I once noticed that a Clojure fn

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread John Gabriele
On Saturday, October 6, 2012 12:03:00 PM UTC-4, Jay Fields wrote: I once noticed that a Clojure fn didn't have a type hint on a return value. Adding ^String made a substantial performance difference. Not knowing the process, I forked, and did a pull request. I got this response:

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Softaddicts
I do not agree at all with you. Any piece of software that gets used widely needs to be maintained with some formal process otherwise there's no way to insure consistency of future releases. It gets worse as you increase the # of people that can modify code. Tickets may seem to you as overhead

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Andy Fingerhut
I don't always remember how to create a patch, either, but I do remember where to go to get the short instructions to do so in case I forget. In case you are curious, the process for creating a patch is documented here, under the heading Developing and submitting patches to Clojure and Clojure

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Andy Fingerhut
I would agree that the CA pain is overemphasized if the submitter lives in the USA or Canada. It isn't difficult at all. I have since heard that to get a letter from Russia to the USA, there are several methods, but they range from inexpensive-but-can-take-months-and-are-unreliable, to

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Rich Hickey
On Oct 6, 2012, at 12:02 PM, Jay Fields wrote: The CA process isn't what stops me from contributing, the post a patch to Jira is what seems broken to me. I don't even remember how to create a patch. Clojure is on github - we live in a fork pull request world, it's time for Clojure to get on

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread aboy021
It would be nice if there were an alternative to the CA for small documentation contributions. Wikipedia is largely built up from a small pool of dedicated people but many valuable contributions come from small anonymous edits. On Saturday, 6 October 2012 18:22:32 UTC-5, Luc wrote: The

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Softaddicts
For documentation purposes, I think it could be relaxed but it would still need some reviewing process. The main concern here's is to avoid cloning other published stuff with legal rights either intentionally or not. Luc P. It would be nice if there were an alternative to the CA for small

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Ben Mabey
On Oct 6, 2012, at 6:04 PM, Michael Klishin michael.s.klis...@gmail.com wrote: 2012/10/7 Softaddicts lprefonta...@softaddicts.ca The validity of a scanned signature or electronic keys is subject to interpretation and assessment on a per case basis especially in civil contracts by the

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Max Penet
Google also has something similiar, and it has probably been checked by an army of layers. http://code.google.com/legal/individual-cla-v1.0.html On Sunday, October 7, 2012 2:25:36 AM UTC+2, Ben Mabey wrote: On Oct 6, 2012, at 6:04 PM, Michael Klishin michael@gmail.comjavascript:

Re: ANN: a Clojure docs site, and github organization

2012-10-06 Thread Softaddicts
It works for Oracle because they have the $$$ to support it. You just confirmed that we are on the same wavelength, they have the weapons to nail anyone who would like to exercise exclusive rights on some contribution made under their CA even if that individual lives in Kazakhstan. They have the

Re: ANN: a Clojure docs site, and github organization

2012-10-05 Thread Mayank Jain
On Fri, Oct 5, 2012 at 6:54 PM, Michael Klishin michael.s.klis...@gmail.com wrote: 2012/10/5 Michael Fogus mefo...@gmail.com You say that as if it's a bad thing. I'm of the opinion that these kinds of efforts should have a low barrier to contribution and be fun. My apologies, I did not

Re: ANN: a Clojure docs site, and github organization

2012-10-05 Thread Andy Fingerhut
On Oct 4, 2012, at 1:34 PM, Michael Klishin wrote: There are pretty specific plans about the guides and moving clojuredocs.org forward to 1.4 and (hopefully, at some point) multi-version support. Michael, are these specific plans described anywhere that we could read? Or would you be able

ANN: a Clojure docs site, and github organization

2012-10-05 Thread Michael Jaaka
why don't you use advantage of html and split the site into two panes on left the table of content in hiperlink form and on the right the content reloaded on clickin in link in toc also use numbers for chapters and subchapters dont use bullets for lists, its harder to make references also add

ANN: a Clojure docs site, and github organization

2012-10-04 Thread John Gabriele
Hi all, I seem to have found myself writing some Clojure docs again. They are currently hosted at https://github.com/clojuredocs/cds , and are *currently* on display at http://www.unexpected-vortices.com/clojure/cds/index.html . Though, there are plans in the works to render the docs using the

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Paul deGrandis
This is great to see. Along side efforts like Fogus' REPL love - http://readevalprintlove.fogus.me/ - we're well on our way fixing the documentation problems in our community. I could definitely see something like this migrating into docs.clojure.org once it reached maturity. Huge thanks to

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Laurent PETIT
2012/10/4 Paul deGrandis paul.degran...@gmail.com This is great to see. Along side efforts like Fogus' REPL love - http://readevalprintlove.fogus.me/ - we're well on our way fixing the documentation problems in our community. I could definitely see something like this migrating into

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Bronsa
Starting two different projects at the same time with almost the same purpose seems a waste of efforts... Wouldn't it be better for readevalprintlove and clojuredocs to join forces from the beginning? 2012/10/4 Laurent PETIT laurent.pe...@gmail.com 2012/10/4 Paul deGrandis

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Michael Klishin
2012/10/5 Bronsa brobro...@gmail.com Wouldn't it be better for readevalprintlove and clojuredocs to join forces from the beginning? It's not clear what readevalprintlove wants to be. clojuredocs has been discussed for a while by some people who care about Clojure documentation. There are

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Paul deGrandis
Sorry, I couldn't resist the temptation to remind you of this: http://www.ted.com/talks/derek_sivers_keep_your_goals_to_yourself.html DOh! (and this is one of my favorite TED talks!) Indeed, I didn't mean to state what was going to done before it was done - just that I was happy to see

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Michael Fogus
readevalprintlove looks like a fancy playground so far. You say that as if it's a bad thing. I'm of the opinion that these kinds of efforts should have a low barrier to contribution and be fun. It's difficult to motivate people to perform a thankless task, so it should seem like play as much as

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Michael Fogus
Starting two different projects at the same time with almost the same purpose seems a waste of efforts... Wouldn't it be better for readevalprintlove and clojuredocs to join forces from the beginning? All information should be freely available, so the sharing aspect is present from the start.

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread David Nolen
On Thu, Oct 4, 2012 at 7:48 PM, Michael Fogus mefo...@gmail.com wrote: readevalprintlove looks like a fancy playground so far. You say that as if it's a bad thing. I'm of the opinion that these kinds of efforts should have a low barrier to contribution and be fun. It's difficult to

Re: ANN: a Clojure docs site, and github organization

2012-10-04 Thread Grant Rettke
On Thu, Oct 4, 2012 at 6:48 PM, Michael Fogus mefo...@gmail.com wrote: readevalprintlove looks like a fancy playground so far. You say that as if it's a bad thing. I'm of the opinion that these kinds of efforts should have a low barrier to contribution and be fun. It's difficult to motivate