Ratgeber

Wie groß darf ein Pull Request sein?

Sie erfahren, woran Sie zu große Pull Requests erkennen, wie Sie Änderungen sinnvoll aufteilen und welche Azure-DevOps-Grenzen Reviews setzen.

Ein Pull Request darf so groß sein, dass Reviewer ihn in einem konzentrierten Durchgang vollständig prüfen können. Sobald eine Änderung nicht mehr als eine klar zusammenhängende Einheit lesbar ist, ist der Pull Request für Azure Repos meist zu groß.

Entscheidend ist damit nicht eine feste Zeilenzahl, sondern ob fachliche Absicht, technische Änderung und Risiken ohne ständiges Umdenken erkennbar bleiben. Für Teams mit Azure DevOps Services hängt diese Größe auch davon ab, wie Sie Reviews im Alltag anlegen und vorbereiten.

Hilfreich ist vor allem eine klare Grenze pro PR:

  • eine erkennbare Änderungsidee
  • ein nachvollziehbarer Zusammenhang
  • ein Review, das in einem Arbeitsblock machbar bleibt

Wenn Sie Änderungen erst sammeln und später sortieren, wird das Review unnötig schwer. Für die Vorbereitung passen je nach Situation ein sauber angelegter Pull Request oder ein Draft Pull Request.

Was Reviewer realistisch prüfen können

Reviewbar ist ein Pull Request dann, wenn eine fachkundige Person ihn ohne Themenwechsel lesen und bewerten kann. Entscheidend ist nicht die reine Menge an Code, sondern die geistige Last: Wie viele Annahmen, Risiken und Prüfpfade müssen gleichzeitig im Kopf bleiben?

In Azure Repos prüfen Reviewer meist mehrere Ebenen zugleich:

  • fachliche Absicht und erwartetes Verhalten
  • Randfälle und mögliche Seiteneffekte
  • Verständlichkeit der Änderung im Gesamtsystem
  • Passung der Tests zur eigentlichen Änderung
  • Folgen für Betrieb, Konfiguration oder Schnittstellen

Schwierig wird es, wenn ein PR zwischen diesen Ebenen springt. Wer in einem Durchgang zugleich Anwendungslogik, Testumbau, Konfigurationsanpassungen und strukturelle Änderungen bewerten soll, verliert leicht den roten Faden. Dann steigt nicht nur der Leseaufwand, sondern auch das Risiko, dass einzelne Punkte ungeprüft bleiben.

Für Tech Leads gehört außerdem der Review-Prozess selbst zur Größe eines PR. Azure-Repos-Branch-Policies sind standardmäßig jeweils deaktiviert. Laut Microsoft Learn, „Branch policies overview“ und „Use branch policies“, gelesen am 01.11.2026, lassen sich unter anderem Mindestanzahl an Reviewerinnen und Reviewern, verknüpfte Work Items, Kommentarauflösung, Build Validation, Status Checks und automatisch hinzugefügte Reviewer festlegen.

Relevant für die Praxis ist vor allem die letzte Iteration. Wenn Ihr Team verlangt, dass nach neuen Pushes mindestens eine Freigabe auf der letzten Iteration vorliegen muss, werden nachträglich angehängte Änderungen schnell unübersichtlich. Eine Iteration ist der jeweils neue Stand eines Pull Requests nach weiteren Commits.

Ein PR ist deshalb meist passend geschnitten, wenn Reviewer Absicht, Risiko und Prüfweg früh erkennen und bis zum Ende beim selben Gegenstand bleiben.

Woran Sie erkennen, dass ein Pull Request zu groß ist

Sie sehen einen zu hohen Kartenstapel neben einer Lupe als Hinweis auf einen zu großen Pull Request.

Ein zu großer Pull Request fällt oft nicht zuerst durch die Diff-Menge auf, sondern durch den Review-Verlauf. Wenn Sie beim Lesen gedanklich zwischen mehreren Themen springen müssen, ist der Zuschnitt meist zu breit.

Warnzeichen im Alltag sind zum Beispiel:

  • In einem PR stecken unterschiedliche Arten von Änderung, etwa Fachlogik, Umbenennungen, Testumbau und Pipeline-Anpassungen.
  • Kommentare drehen sich vor allem darum, was überhaupt zusammengehört.
  • Nach dem ersten Feedback kommen weitere größere Änderungen dazu, statt nur gezielte Korrekturen.
  • Die Beschreibung muss erst sortieren, welche Teile Vorbereitung sind und welche das Verhalten ändern.
  • Der Build ist grün, aber der Zusammenhang zwischen Diff und Tests bleibt schwer nachvollziehbar.
  • Der PR bleibt liegen, weil niemand ihn in einem konzentrierten Block prüfen möchte.

Auffällig ist auch, wenn formale Änderungen den fachlich wichtigen Teil verdecken. Dazu gehören breite Formatierungen, Verschiebungen oder Umbenennungen. Solche Änderungen sind nicht automatisch falsch, machen Reviews aber schnell unklar, wenn sie mit Verhaltensänderungen vermischt werden.

Für Teams, die neue Werkzeuge beobachten, gilt noch etwas anderes: Ziehen Sie Aussagen zu Qualität, Tempo oder Nutzen nur aus belastbaren Messungen. Für ein Produkt in Entwicklung ist deshalb entscheidend, was tatsächlich gemessen wurde und welcher Stand öffentlich dokumentiert ist.

Wenn Sie zusätzlich einordnen wollen, was beim geplanten Dienst heute gilt und was noch nicht, hilft der Blick auf Status, Datenfluss und Grenzen. Informationen zu den derzeit geplanten Paketen und zum vorgesehenen Bezug stehen getrennt bei den vorläufigen Paketen und der Anmeldung.

Arbeit aufteilen: Stacked Branches, Feature Flags, Refactoring zuerst

Sie sehen verzweigte Linien und verbundene Bausteine als Sinnbild für das Aufteilen von Änderungen.

Große Vorhaben werden dann reviewbar, wenn Sie sie nicht als ein einziges Paket ausliefern, sondern entlang nachvollziehbarer Zwischenzustände schneiden. Jeder dieser Zustände sollte für sich verständlich, baubar und fachlich einordenbar sein.

Stacked Branches sind aufeinander aufbauende Branches oder Pull Requests, bei denen ein späterer PR auf einem früheren aufsetzt, damit jede Änderungseinheit klein und zusammenhängend bleibt. Das ist besonders nützlich, wenn eine Änderung in Schichten entsteht.

Ein typisches Muster ist:

  • zuerst Datenmodell, Vertragsänderung oder Schnittstelle
  • danach die Nutzung im Anwendungscode
  • anschließend Aufräumen, Vereinheitlichung oder das Entfernen alter Pfade

So sehen Reviewer nicht alles gleichzeitig, sondern Ebene für Ebene. Das reduziert Rückfragen, weil jede Stufe eine klarere Absicht hat.

Ein zweites Muster sind Feature Flags. Dabei wird Verhalten schrittweise eingeführt, obwohl Teile der Umsetzung schon integriert sind. Neue Pfade können zunächst deaktiviert bleiben, während Sie die technische Grundlage, die Aktivierung und die Bereinigung in getrennten PRs liefern. Dadurch bleibt jeder Schritt kleiner.

Feature Flags helfen aber nur, wenn ihre Lebensdauer kurz bleibt. Wenn Flags lange liegen bleiben, verschiebt sich Komplexität aus dem Review in Betrieb, Tests und Fehlersuche. Planen Sie deshalb das spätere Entfernen von Anfang an mit.

Ebenso hilfreich ist die Reihenfolge „Refactoring zuerst“. Reine Strukturänderungen wie Umbenennungen, Extraktionen oder Vereinheitlichungen kommen in einen eigenen PR. Erst danach folgt die eigentliche Verhaltensänderung. So trennen Sie bessere Lesbarkeit von geänderter Logik.

Das gilt auch für Tests und Pipelines. Wenn ein Build- oder Testumbau nötig ist, lohnt sich oft ein vorbereitender PR nur für die Pipeline- oder Testbasis. Die fachliche Änderung baut dann auf einer bereits verständlichen Grundlage auf.

Damit diese Aufteilung im Team sichtbar bleibt, sollte auch das verknüpfte Work Item in Azure Boards die Schritte widerspiegeln. Dann ist pro PR erkennbar, welcher Teilfortschritt gerade geprüft wird.

Grenzen, die manche Review-Werkzeuge setzen

Neben dem menschlichen Review gibt es auch technische Grenzen, die für die Zuschnittsfrage relevant sind. Sie sagen nicht, wie groß ein Pull Request sein darf. Sie zeigen aber, ab wann ein zusätzlicher Review-Schritt gar nicht erst greift oder nur noch eingeschränkt läuft.

Für Azure Repos ist Copilot Code Review laut Microsoft Learn, „Sprint 279 Update“, „Review pull requests“ und „Copilot code reviews“, gelesen am 01.11.2026, in Public Preview verfügbar. Es lässt sich auf Organisations-, Projekt- oder Repository-Ebene aktivieren und per Branch Policy automatisch auslösen. Seit Sprint 280 gibt es dafür die Effort Levels Lite und Balanced.

Für die Einordnung der PR-Größe sind vor allem diese Grenzen relevant:

  • nur aktive Pull Requests ohne Merge-Konflikte
  • Repository bis 10 GB
  • bis zu 100 geänderte Dateien
  • bis zu 100 Änderungen
  • Grenzen für gleichzeitige Reviews pro Pull Request, Organisation und Nutzerin oder Nutzer

Microsoft Learn, „Copilot code reviews“, gelesen am 01.11.2026, nennt diese Werte ausdrücklich.

Wesentlich ist außerdem die Art des Ergebnisses: Copilot hinterlässt immer eine Comment Review. Laut Microsoft Learn, „Review pull requests“, gelesen am 01.11.2026, erfüllt das keine Required-Reviewer-Policy und blockiert das Mergen nicht. Für Teams mit verbindlichen Freigaben bleibt es also ein zusätzlicher Hinweis, keine ersetzende Abnahme.

Zur Einordnung gehört auch der Betriebsrahmen. Preview-Funktionen können sich ändern und haben keine SLA. Außerdem nennt Microsoft Learn FAQ, „Copilot code reviews FAQ“, gelesen am 01.11.2026, eine mögliche Verarbeitung außerhalb der Datenresidenzgrenzen Ihrer Azure-DevOps-Organisation. Ob das für Sie bei Datenschutz, DORA, NIS2 oder Mitbestimmung relevant ist, sollten Sie mit Rechtsberatung oder der Datenschutzbeauftragten beziehungsweise dem Datenschutzbeauftragten prüfen.

Häufige Fragen aus der Praxis

Welche Azure-Repos-Policies helfen bei großen Pull Requests wirklich?

Nicht die Diff-Größe selbst, sondern der Prüfpfad lässt sich absichern. In Azure Repos sind laut Microsoft Learn, „Branch policies overview“, „Use branch policies“ und „Securely use repositories, pull requests, and forks in Azure Repos“, gelesen am 01.11.2026, unter anderem diese Policies relevant:

  • Mindestanzahl an Reviewerinnen und Reviewern
  • verknüpfte Work Items
  • Kommentarauflösung
  • Build Validation
  • Status Checks
  • automatisch hinzugefügte Reviewer

Alle sind standardmäßig deaktiviert. Microsoft nennt für Main als Sicherheits-Baseline unter anderem mindestens zwei Reviewer, sensible Pfade mit automatisch hinzugefügten Reviewern, verknüpfte Work Items, Build Validation und aufgelöste Kommentare.

Zählt die Zahl der Commits für die PR-Größe?

Nur indirekt. Viele kleine Commits können einen PR gut erklärbar machen. Sie können ihn aber auch unruhig machen, wenn Korrekturen, Rücknahmen und Nebenthemen gemischt werden.

Wichtiger ist, ob die Iterationen klar bleiben. In Azure Repos ist eine Iteration der neue Stand eines Pull Requests nach weiteren Pushes. Wenn Ihr Team Freigaben auf der letzten Iteration verlangt, wird ein PR schwerer prüfbar, sobald nach dem Feedback noch einmal größere Änderungen hinzukommen.

Was ist bei Audit und Nachvollziehbarkeit wichtiger: Squash oder Merge Commit?

Das hängt vom Nachweismodell Ihres Teams ab. Laut Microsoft Learn, „Securely use repositories, pull requests, and forks in Azure Repos“, gelesen am 01.11.2026, ist „Limit merge types“ keine direkte Sicherheitskontrolle, sondern steuert die Historie.

Squash erzeugt eine kompaktere Zielhistorie. Wenn für Nachvollziehbarkeit die genaue Commit-Folge wichtig ist, empfiehlt Microsoft Merge-Commit-Strategien statt Squash. Für die Reviewbarkeit eines großen PR ist das aber nur ein Randpunkt: Der Prüfaufwand entsteht vor dem Merge.

Was folgt daraus praktisch?

Schneiden Sie PRs so, dass Policies, Builds, Kommentare und Freigaben auf einen klaren Gegenstand treffen. Dann passt nicht nur der Diff besser zum Review, sondern auch der gesamte Ablauf in Azure Repos.

Nächster Schritt

Treffen Sie für Ihr Team eine einfache Arbeitsvereinbarung: Ein Pull Request geht erst ins Review, wenn Ziel, Grenze und Prüffrage in zwei bis drei Sätzen stehen. So klären Sie den Zuschnitt vor dem ersten Kommentar.

Praktisch hilft eine kurze Checkliste:

  • Was ändert sich konkret?
  • Was gehört bewusst nicht mehr in diesen PR?
  • Woran soll das Review zuerst ansetzen?

Falls Sie Entwicklungen rund um Azure DevOps Services beobachten: Polier ist Stand 01.11.2026 in Entwicklung und noch nicht verfügbar.

Alle Ratgeber