code review 4309043: doc: update contrib.html to be more enticing

doc: update contrib.html to be more enticing
doc: refer to golang-dev instead of -nuts in contribute.html

[adg, 2011-03-23 03:47:54]

Hello r (cc: golang-dev@googlegroups.com),

I'd like you to review this change to
https://go.googlecode.com/hg/

[r, 2011-03-23 03:54:49]

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html
File doc/contrib.html (right):

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html#newcode14
doc/contrib.html:14: (Of course, you should search for an existing issue before
filing a new one.)
s/search for/check it's not/
s/filing/creating/

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html#newcode24
doc/contrib.html:24: Go is an Open Source project and we welcome contributions
from the community.
s/Open Source/open source/

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html#newcode32
doc/contrib.html:32: <a
href="http://code.google.com/p/go/issues/list?q=status=HelpWanted">HelpWanted</a>.
there aren't enough of those.  maybe 

Check the tracker for issues that interest you.  Those labeled [only one l in
the middle] HelpWanted are particularly in need of outside help.

http://codereview.appspot.com/4309043/diff/1/doc/contribute.html
File doc/contribute.html (right):

http://codereview.appspot.com/4309043/diff/1/doc/contribute.html#newcode24
doc/contribute.html:24: mailing list</a> to discuss what you plan to do.  This
gives everyone a
is that what you want?  it's fine with me but i'm surprised. 'everyone' is not
on dev.  but maybe everyone we want to comment.

[adg, 2011-03-23 05:24:42]

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html
File doc/contrib.html (right):

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html#newcode14
doc/contrib.html:14: (Of course, you should search for an existing issue before
filing a new one.)
On 2011/03/23 03:54:49, r wrote:
> s/search for/check it's not/
> s/filing/creating/

Done.

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html#newcode24
doc/contrib.html:24: Go is an Open Source project and we welcome contributions
from the community.
On 2011/03/23 03:54:49, r wrote:
> s/Open Source/open source/

Done.

http://codereview.appspot.com/4309043/diff/1/doc/contrib.html#newcode32
doc/contrib.html:32: <a
href="http://code.google.com/p/go/issues/list?q=status=HelpWanted">HelpWanted</a>.
On 2011/03/23 03:54:49, r wrote:
> there aren't enough of those.  maybe 
> 
> Check the tracker for issues that interest you.  Those labeled [only one l in
> the middle] HelpWanted are particularly in need of outside help.

Done.

http://codereview.appspot.com/4309043/diff/1/doc/contribute.html
File doc/contribute.html (right):

http://codereview.appspot.com/4309043/diff/1/doc/contribute.html#newcode24
doc/contribute.html:24: mailing list</a> to discuss what you plan to do.  This
gives everyone a
On 2011/03/23 03:54:49, r wrote:
> is that what you want?  it's fine with me but i'm surprised. 'everyone' is not
> on dev.  but maybe everyone we want to comment.

I've changed the wording slightly.

I think anyone who's gotten to this stage should be posting to golang-dev. The
role of golang-nuts seems to have become primarily problem solving,
announcements, and more broad Go discussion. Let's discuss hacking on the
project on golang-dev.

[r, 2011-03-23 18:26:47]

http://codereview.appspot.com/4309043/diff/4001/doc/contrib.html
File doc/contrib.html (right):

http://codereview.appspot.com/4309043/diff/4001/doc/contrib.html#newcode33
doc/contrib.html:33: open issues that interst you. Those labelled
s/interst/interest/
as said before, s/labelled/labeled/ either is correct so why use the longer one?
plus it's more typical US style

http://codereview.appspot.com/4309043/diff/4001/doc/contribute.html
File doc/contribute.html (right):

http://codereview.appspot.com/4309043/diff/4001/doc/contribute.html#newcode23
doc/contribute.html:23: mail to the <a
href="http://groups.google.com/group/golang-dev">golang-dev
i disagree. discussions should be on nuts not dev. more eyes, more public.

[rsc, 2011-03-23 18:28:19]

http://codereview.appspot.com/4309043/diff/4001/doc/contribute.html
File doc/contribute.html (right):

http://codereview.appspot.com/4309043/diff/4001/doc/contribute.html#newcode23
doc/contribute.html:23: mail to the <a
href="http://groups.google.com/group/golang-dev">golang-dev
I don't think golang-dev is right.

Many "something new" are going to be things that the contributor
thinks belong in the standard library but actually do not.  In that
case, being on golang-nuts means that someone else who already
wrote that library is likely to see it and respond.

This is a border case, because it's a discussion that might lead
to real development, but equally likely might not.  In the latter
case it belongs more on golang-nuts and the people who can
answer best are more likely to be there. 

Also I try not to pass up opportunities to encourage people to
post actual signal to golang-nuts.

[adg, 2011-03-23 23:32:31]

On 24 March 2011 05:26,  <r@golang.org> wrote:
> http://codereview.appspot.com/4309043/diff/4001/doc/contrib.html#newcode33
> doc/contrib.html:33: open issues that interst you. Those labelled
> s/interst/interest/
> as said before, s/labelled/labeled/ either is correct so why use the
> longer one? plus it's more typical US style

Sorry, I simply missed it. I personally prefer "labelled" but I'll
defer to the US style.

> i disagree. discussions should be on nuts not dev. more eyes, more
> public.

Agree with both what you and Russ have said (particularly Russ'
comments on signal:noise ratios).

PTAL

Thanks,
Andrew

[r, 2011-03-23 23:34:32]

LGTM

[adg, 2011-03-24 00:06:12]

*** Submitted as http://code.google.com/p/go/source/detail?r=88e7824cdba3 ***

doc: update contrib.html to be more enticing
doc: refer to golang-dev instead of -nuts in contribute.html

R=r, rsc
CC=golang-dev
http://codereview.appspot.com/4309043