Zum Inhalt springen

Englisch im Code Review

Code Review ist nicht nur technisches Feedback — es ist Teamkommunikation. Unpassende Formulierungen koennen:

  • Arrogant oder sarkastisch wirken
  • Die Motivation von Kollegen verletzen
  • Missverstaendnisse verursachen (besonders in interkulturellen Teams)
  • Den Eindruck erwecken, Sie wuerden “herumnergeln” statt aufrichtig zu helfen

Die gute Nachricht: Es gibt einen Satz von Standardausdruecken, die alle verstehen.

“Nit” kommt von “nitpick” (Haare spalten), ist aber im Code Review ein positiver Begriff: “Das ist klein, beeinflusst nicht das grosse Ganze, aber ist verbesserungswuerdig.”

❌ "This variable name is bad"
✅ "Nit: could we rename this to `userCount`?"
✅ "Minor: I'd prefer `userCount` for clarity"

Wann verwenden:

  • Benennung, Formatierung, Stilfragen
  • Refactoring-Vorschlaege (nicht zwingend, aber besser)
  • Dokumentationsergaenzungen

Abkuerzung, die bedeutet: Sie haben das Review abgeschlossen und stimmen dem Merge zu.

LGTM! 👍

Oder formeller:

LGTM. Great implementation.

Schwerwiegendes Problem, das vor dem Merge behoben werden muss.

Blocker: This will cause a race condition in `handleUserLogin`.
Here's why: ...

Wenn jemand einen Bug, ein Performance-Problem oder eine versteckte Anforderung findet und Sie bestaetigen, dass sie Recht haben.

Nice catch! I didn't think about the edge case where `null` ...

5. Could you elaborate (Koennten Sie das naeher erlaeutern)

Abschnitt betitelt „5. Could you elaborate (Koennten Sie das naeher erlaeutern)“

Wenn Sie nicht verstehen, warum etwas so geschrieben wurde, oder die Designentscheidung nachvollziehen moechten.

Could you elaborate on why we're using `Map` instead of `Object`?

Freundlichere Version:

I'm curious about the choice to use `Map` here. Could you walk me through the reasoning?
  • Nitpick: Staerkere Version von “nit”
  • Looks good: Teilweise Zustimmung zu einem Abschnitt
  • We should probably: Sanfter Vorschlag
  • Have you considered: Offene Frage zu Alternativen
  • Ship it: Informellste Zustimmung — bereit fuer die Veroeffentlichung

Formel: Kontext → Problem → Vorschlag

❌ "This code is inefficient"
✅ "In `processUserData`, iterating `O(n²)` might be slow with large datasets.
Could we use a `Set` to get `O(n)` instead?"
❌ "That's wrong"
✅ "I see your approach. One concern: `Math.random()` isn't cryptographically
secure for auth tokens. Should we use `crypto.getRandomValues()`?"
❌ LGTM
✅ LGTM! Curious: did you benchmark this against the regex approach we discussed?
I'm wondering if it's noticeably faster for production scale.

Ihr Gedanke in der Muttersprache → Drei englische Optionen → Die passendste waehlen

Sie moechten sagen: “Hier gibt es eine Race Condition, mehrere Anfragen kollidieren”

Basic (Direct):
"There is a race condition here, multiple requests will conflict"
Intermediate (Natural):
"Multiple concurrent requests could cause a race condition"
Native (Idiomatic):
"Concurrent requests might race here. Consider using a lock or queue."

Sie moechten sagen: “Dieser Variablenname ist zu lang, koennte man ihn kuerzen”

Native (Idiomatic):
"Nit: `getCurrentUserAuthenticationStatusFlag` is a bit verbose.
How about `isAuthenticated`?"
Tipp: Ein konkreter Vorschlag ist hilfreicher als nur "kuerzen"
Fehlerhafter AusdruckGrundBessere Version
”This code is not good”Zu direkt, wirkt arrogant”Could we refactor this for clarity?"
"You must change this”Klingt wie ein Befehl”We should probably change this"
"This is wrong”Verletzend”This might cause X in scenario Y"
"The code of the function is bad”Uebermaessiges “of""The function could be clearer”
SituationAusdruck
Zustimmung + KleinigkeitLGTM, just one nit: …
Anderer Meinung bei einer EntscheidungI see your approach, but have we considered…?
Schwerwiegendes ProblemBlocker: This will cause…
Kleiner VorschlagNit: Could we…?
Zustimmung + LernwunschNice! Could you explain why you chose…?
UnsicherI’m not sure about this. Could we discuss?
Vollstaendige ZustimmungLGTM! Ship it.