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

-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 > site. > > I do have some followup questions on clojure

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

2012/10/10 Andy Fingerhut > *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 these changes, but

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

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 Kli

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

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 > > >> Wouldn't it be better for readevalprintlove and cl

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

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

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

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

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

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

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 i

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

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 > > > wrote: > > > > 2012/10/7 Softaddi

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

On Oct 6, 2012, at 6:04 PM, Michael Klishin wrote: > > > 2012/10/7 Softaddicts >> 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 >> diverse >> legal systems on Earth. >> >> It'

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

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

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 v

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

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 diverse legal systems on Earth. It's not the Clojure community that is behind, it's the legal systems of many countries that did not follow

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

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 ge

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

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

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

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

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 but

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

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

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 d

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

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 publis

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

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

ANN: a Clojure docs site, and github organization

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 disq

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

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 ab

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

On Fri, Oct 5, 2012 at 6:54 PM, Michael Klishin wrote: > > > 2012/10/5 Michael Fogus > >> 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 imply that it is a bad thing, onl

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

On Thu, Oct 4, 2012 at 6:48 PM, Michael Fogus 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 people to pe

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

On Thu, Oct 4, 2012 at 7:48 PM, Michael Fogus 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 people to

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

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

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

> 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

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 p

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

I think the goals are sufficiently different. 2012/10/5 Bronsa > >> Wouldn't it be better for readevalprintlove and clojuredocs to join >> forces from the beginning? > > -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send ema

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

2012/10/5 Bronsa > 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 pretty specific plans

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

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 > 2012/10/4 Paul deGrandis > >> This is great to see. Along side effo

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

2012/10/4 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.orgonce it re

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

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 ev

ANN: a Clojure docs site, and github organization

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 sam