Dokumentation

Wie Coroid seine eigene Arbeit überprüft

Warum ein pull request aus Coroid bereits überprüft vorliegt und welche Aussage jede Überprüfungsebene tatsächlich trifft.

Ein pull request aus Coroid durchläuft die Überprüfung, bevor Sie ihn sehen. Dieser Abschnitt erläutert die Bedeutung sowie die Konfigurationsmöglichkeiten.

Die Ebenen

Überprüfung ist nicht einheitlich. Vier Ebenen werden ausgeführt, wobei jede eine andere Frage beantwortet.

Ihr Test-Suite. Das stärkste verfügbare Signal, da es bereits widerspiegelt, was Ihr Team als wichtig erachtet. Coroid führt es in einem sauberen Arbeitsbereich für jeden Task aus.

Qualitätsgates. Richtlinienbasierte Prüfungen – Abdeckungsgrad, Linting, Sicherheitsscans sowie Browser-Tests. Blockierende Gates stoppen den Task; beratende Gates dokumentieren einen Befund und erlauben das Weiterführen. Siehe Qualitätsrichtlinien und Gates.

Rezension. Ein Rezensions-Agent liest die fertige Diff und erstellt Befunde. Behebbare Befunde werden als Nacharbeit an den Entwickler zurückgesendet; die übrigen werden dem pull request zugeordnet.

Nachweise. Vorschau-Deployments, Scan-Ergebnisse sowie Abdeckungsdifferenzen werden dem pull request selbst zugeordnet, sodass die Überprüfung zusammen mit dem Code vorliegt. Siehe Rezensionsnachweise.

Was dies beweist und was nicht.

Die Überprüfung bestätigt, dass die Änderung das tut, was sie verspricht, das Bestehende nicht stört und Ihre festgelegten Standards erfüllt.

Sie beweist nicht dass die Änderung die richtige Entscheidung zum Bauen ist. Das ist der Zweck der Spezifikation sowie Ihrer Rezension.

Eine Änderung kann alle Prüfungsebenen durchlaufen und dennoch fehlerhaft sein. Diese Unterscheidung klar zu halten, macht das gesamte System vertrauenswürdig – sobald die Verifizierung als endgültiges Urteil dargestellt wird, hören die Nutzer mit der Rezension auf.

Der Sinn dahinter, dies zuerst auszuführen

Jede Prüfungsebene läuft bereits vor der Erstellung eines pull request ab, sodass Fehler als Nacharbeit innerhalb des Prozesses auftreten – statt als pull request, das erst später abgelehnt würde.

Es ist günstiger, im Arbeitsbereich zu scheitern als auf dem Bildschirm. Die Rezension sollte der erste Menschliche Blick sein, nicht der erste Eindruck.

Wo Sie beginnen

Falls Sie dies zum ersten Mal konfigurieren:

  1. Stellen Sie sicher, dass Ihr Test-Suite ausgeführt wird – siehe Konfiguration von Build und Test. Alles andere spielt keine Rolle, wenn dies nicht korrekt eingerichtet ist.
  2. Legen Sie eine Standard-Richtlinie für die Organisation auf Ihrem Standard Niveau fest, nicht auf dem strengsten.
  3. Verbinden Sie die Beweismittel-Anbieter, die Sie bereits nutzen.
  4. Fügen Sie die Prüfschritte nacheinander hinzu, zunächst als empfehlende Regeln.

In diesem Abschnitt