Live data from Hacker News

The Minimally-Nice Open Source Software Maintainer

brson.github.io

11–20 of 61 posts

Re: The Minimally-Nice Open Source Software Maintainer

#11
One huge problem is that September never ended... (https://en.wikipedia.org/wiki/Eternal_September)

What I mean is, there are lots of people who are not as smart as they think they are, and they won't STFU and RTFM, etc...

Send not to know at whom the Torvalds curses, he curses at thee.

Frankly, I think the author's original position was correct: Emphasize credit for authors of RFCs and you'll get fools authoring RFCs for the credit. Sheesh!

Re: The Minimally-Nice Open Source Software Maintainer

#12

One huge problem is that September never ended... ( https://en.wikipedia.org/wiki/Eternal_September ) What I mean is, there are lots of people who are not as smart as they think they are, and they won't STFU and RTFM, etc... Send not to know at whom the Torvalds curses, he curses at thee. Frankly, I think the author's original position was correct: Emphasize credit for authors of RFCs and you'll get fools authoring R…

I agree that perverse incentives are possible, but I think that stance is a bit pessimistic. Being the author of an RFC grants you no social capital unless that RFC is good enough to get accepted (and if it's good enough to get accepted, then it's a good thing someone took the time to write it!). Additionally, the amount of social capital one receives from being known as the author of an RFC is very minor (especially since Rust RFCs only represent the beginning of the conversation, not the end, and the features any given RFC describes can change drastically between RFC and eventual stabilization, and god only knows how many people are responsible for the end result by that point).

(There's only one accepted Rust RFC whose author I can name from memory, and that's only because it's an RFC that I didn't like. :P The knife cuts both ways!)

Re: The Minimally-Nice Open Source Software Maintainer

#14
post #7

> But before you fly off the chain, prove your undeniable superiority, and prove that they are wrong, let me suggest instead that you do something crazy, that you do the opposite: that you prove they are right. I'm a bit uneasy about this. If you spend your time agreeing with a suggestion that your initial reaction is to reject, you probably won't have the patience to go back and question it after the fact. You'll al…

> but I believe thinking critically is important

I think you have to differentiate between thinking and communicating. Thinking comes first, unhindered by concerns for social niceties and hurt feelings.

Then, you communicate by expressing what you've concluded in a way that does account for the fact that you're conveying a message to a human being, with all the baggage that entails.

Re: The Minimally-Nice Open Source Software Maintainer

#16

One thing I wish GitHub made easier is responding to a pull request with a patch rather than encouraging reviewers to type up a bunch of suggestions that the original submitter will have to turn into a patch themselves. If you have a better idea how to accomplish part of a suggested change, you can communicate that more clearly by making a patch and leaving a comment explaining why. GitHub should encourage this and a…

Could this be accomplished with a pull request into their feature branch?

Re: The Minimally-Nice Open Source Software Maintainer

#17
post #7

> But before you fly off the chain, prove your undeniable superiority, and prove that they are wrong, let me suggest instead that you do something crazy, that you do the opposite: that you prove they are right. I'm a bit uneasy about this. If you spend your time agreeing with a suggestion that your initial reaction is to reject, you probably won't have the patience to go back and question it after the fact. You'll al…

An important aspect of thinking critically is the willingness to entertain opposing ideas as true. If you can reject an opposing position even while granting it the benefit of the doubt, then that says good things about the strength of your original position. But if you can't reject such an opposing position, then that helps to inform how you should respond to people with that position since now you know that, rather than being illogical, it's merely that their axioms are different.

Re: The Minimally-Nice Open Source Software Maintainer

#18

One thing I wish GitHub made easier is responding to a pull request with a patch rather than encouraging reviewers to type up a bunch of suggestions that the original submitter will have to turn into a patch themselves. If you have a better idea how to accomplish part of a suggested change, you can communicate that more clearly by making a patch and leaving a comment explaining why. GitHub should encourage this and a…

You could automate out half of feedback by automating a comment that says "add more tests"

Even if you added tons of tests, you'll get add more tests. It almost makes more sense to write tests and hold them, so you can respond with them.

Re: The Minimally-Nice Open Source Software Maintainer

#19

One thing I wish GitHub made easier is responding to a pull request with a patch rather than encouraging reviewers to type up a bunch of suggestions that the original submitter will have to turn into a patch themselves. If you have a better idea how to accomplish part of a suggested change, you can communicate that more clearly by making a patch and leaving a comment explaining why. GitHub should encourage this and a…

Have you seen https://github.com/blog/2247-improving-collaboration-with-fo... ?

Re: The Minimally-Nice Open Source Software Maintainer

#20
post #3

The worst maintainers are the ones who refuse to say no when they mean no or want to say no. I've seen maintainers waste weeks or months of a contributors time on work that they never intend to accept because they're trying to avoid confrontation up front.

I'd say that's a distinct skill that requires a different approach. Big projects have this problem less, because they have so many conflicting stakeholders and they get so much more practice rejecting random patches. But for little projects with one or few maintainers it's easy to look at every random contribution and be flattered that someone would bother to take the time to try and give back, which at the same time predisposes you to feeling like rejecting them would be some sort of betrayal. It's important to be magnanimous here when possible, but at the same time when they inevitably ask "why wasn't this accepted?" sometimes there simply isn't a more satisfying answer than "this doesn't fit with our unspoken philosophy of what the project should be".

To use an example of a project I've contributed to, Dungeon Crawl Stone Soup has an explicit wiki page for "patches that we will not accept, so don't even bother asking": https://crawl.develz.org/wiki/doku.php?id=dcss:planning:wont...

Post reply on HN