News for hackers. Stuff that matters.
Re:Helping newcomers become contributors to open projects by rurban on Tuesday October 29, 2019 @07:56AM (#21386100)
Beware, pitfalls.

* Make governance explicit: Mostly backfires.

* Have and enforce a code of conduct: Mostly backfires.

All the recent dramas were entirely caused by having explicit governance and code of conduct bylaws, which would not have happened (and didn't happen) without these before. It only encourages public fights over these.

Re:Helping newcomers become contributors to open projects by elweston2 on Tuesday October 29, 2019 @08:21AM (#21386288)
Another is eat your own dogfood. If you enforce rules on others, enforce them on yourself. One project I keep an eye on and gave up trying to contribute to has users who berate others for something then turn around and do the same thing. If you make everyone else do code reviews. You do them too. If you want some sort of special spacing. Make the tools do it. Do not enforce them in code reviews. Teach the users how to setup the tools. Make a FAQ that shows how. Point people at it. You know where everything is, they dont.

Another pitfall I see is what I call 'claiming with neglect' where a user will claim something then let no one else touch it, usually in a pull request that someone put a bunch of time into. But then not do what they said they were going to do. Two years later the pull request dies on the vine and nothing changes. The person who made the request usually just wanders off due to lack of feedback.

Another is letting pull requests sit for years. Just set a max timeframe. If it does not go in that time close it. Do leave the person hanging. I get that happens on a dead project. But on a project that is obviously active? Give that pull request some love. Close it, tweak it, or merge it (something!).

Re:Helping newcomers become contributors to open projects by matheusmoreira on Tuesday October 29, 2019 @09:36AM (#21386948)
Yeah. I've witnessed so many controversies I started archiving and collecting them. Code of conduct enforcement is flawed to say the least.
Re:Helping newcomers become contributors to open projects by at_a_remove on Tuesday October 29, 2019 @11:00AM (#21387889)
I would be interested in seeing these.

My naive hope is that a code of conduct could be crafted with defensive measures to at least mitigate such problems, but that is probably hopeless in the face of bad actors.

Re:Helping newcomers become contributors to open projects by matheusmoreira on Tuesday October 29, 2019 @11:48AM (#21388487)
> I would be interested in seeing these.

I have some links bookmarked:

https://github.com/nodejs/TSC/issues/325

https://archive.is/XcxSf

https://archive.is/YnGGz

https://archive.is/EJmJ7

That directly followed a failed attempt at enforcement that led to a fork:

https://web.archive.org/web/20170821212745/https://github.co...

This article covers the whole thing:

https://theoutline.com/post/2206/the-node-js-code-of-conduct...

An HN discussion:

https://news.ycombinator.com/item?id=15101668

> My naive hope is that a code of conduct could be crafted with defensive measures to at least mitigate such problems

The problem isn't the letter of the law, it's that the rules don't seem to apply to certain groups of people.

Re:Helping newcomers become contributors to open projects by veddox on Tuesday October 29, 2019 @08:14AM (#21386251)
Hm, I think I know some of the cases you're thinking of. (Specifically, GNU and Stack Overflow come to mind?)

But don't you think these were (at least in part) only the visible outbreaks of conflicts that had already been simmering for a long time? If that is so, introducing an explicit governance/CoC may have been a long overdue step that ended up breaking some crockery, but only because it wasn't enacted early enough...

Re:Helping newcomers become contributors to open projects by scrollaway on Tuesday October 29, 2019 @09:13AM (#21386704)
The general rule is that a project shouldn't need a code of conduct. A code of conduct outlines basic decency rules in which case, if it gets to the point that the project needs to be explicit about them to keep a good ambiance, that project has deeper seated issues.

Codes of conduct are great when the etiquette is ambiguous. Open source projects are not one of those.

When the users are in the wrong, you should be able to kick them out uncontroversially. And when the maintainers are in the wrong... They tend to ignore their own CoC anyway. Speaking from experience, I've tried contributing to a particular PSF project in the past, adding a feature to support a use case the maintainer did not like (supporting tab indent option in a code formatter), which was ignored and closed; and when I pointed out to the maintainer that his behaviour was in breach of the CoC, that too was ignored. What are you gonna do? In the end I had to fork the project.

Re:Helping newcomers become contributors to open projects by Double_a_92 on Tuesday October 29, 2019 @11:33AM (#21388296)
I really like the Djando CoC (in case someone needs a template): https://www.djangoproject.com/conduct/