Handling disagreements

Disagreements happen in every project, even healthy ones. Two smart people can look at the same code and reach different conclusions. The problem is rarely the disagreement itself — it is how we express it. When we say "you are wrong", we shut down the conversation. When we share our perspective kindly, we keep it open.

In open source, your words are often the only thing the other person sees. A harsh message can end a collaboration. A respectful one can turn a disagreement into a better decision.

Separate the idea from the person

When you disagree, challenge the idea, not the person. Say "I see this differently" instead of "you are wrong". This keeps the discussion focused on the topic and away from personal feelings.

Bad: "You're wrong."

Good: "I see things a bit differently. Here's my perspective — what do you think?"

Explain your reasoning

A disagreement is more useful when you explain why you think the other way. Simply stating "this is better" helps no one. Share your reasoning and the facts you are basing it on, so the other person can understand and respond.

Good: "I'm not sure about this approach because it could make the code slower on large inputs. Am I missing something, or do you see it differently?"

Stay curious

Before you argue, try to understand the other side. Maybe they know something you do not. Ask questions instead of making statements. This often leads to a better solution than either of you started with.

Good: "Interesting — why did you choose this design? I want to understand before I share my concerns."

When to step back

Not every battle is worth fighting. If a disagreement is about a small detail and the project owner has a strong opinion, it may be best to accept it gracefully. Knowing when to let go keeps the relationship healthy.

Good: "That's a fair point. I'll go with your suggestion on this one — thanks for the explanation."

Ready-to-use phrases

"I see it a little differently — could I share my view?"

"I understand your reasoning, but I have a concern about ..."

"Let's look at the data together and decide."

"We seem to disagree on this. Could we talk through both options?"

A simple rule

Your goal in a disagreement is not to win, but to find the best outcome while keeping the relationship intact. Challenge the idea, explain your reasons, and listen. That is how disagreement becomes progress instead of conflict.