Dokumentation

Ergebnisverträge

Was als „erledigt“ gilt, beschreibt den Zustand eines Arbeitspakets nach dem Zusammenführen in pull request, formuliert von der Person, die die Anfrage gestellt hat.

Tests und Rezensionen zeigen Ihnen, ob eine Änderung das tut, was sie verspricht. Ein Ergebnisvertrag spezifiziert, was nach der Auslieferung gültig sein soll und wie dies überprüft werden kann: welche Prozesse erfolgreich ablaufen, welcher Fehler nicht mehr auftritt, auf welchen Pfaden, nach welchem Datenverkehr und für wie lange.

Jede neue Aufgabe enthält einen solchen Vertrag. Er gehört der Person, die die Arbeit angefordert hat, niemals dem Agenten, der die Umsetzung übernimmt – somit kann der ausführende Agent den Erfolg nicht neu definieren.

Wo Sie ihn sehen

Öffnen Sie die Aufgabe in Factory. Das Ergebnisverträge Karten zeigen jeden Vertrag mit seiner Art, Version, Status, Erfolgsbedingung, benötigter Auswirkung und der Beobachtungsdauer.

Wie ein Vertrag entsteht

Coroid entwirft den technischen Vertrag bei der Erstellung der Aufgabe, basierend auf den Angaben der Anfrage:

  • Aus den Akzeptanzkriterien. Eine Aufgabe mit Akzeptanzkriterien – aus ihrer Spezifikation oder ihrem Plan – erhält einen Entwurf, dessen Erfolgsbedingung darin besteht, dass die genannten Prozesse erfolgreich ablaufen, überprüft durch einen Browser-Test.
  • Aus einem Signal. Eine Anfrage, die aus der Überwachung, einer Automatisierung oder dem Arbeitsaufnahme-Prozess API stammt, enthält das zugrundeliegende Signal: den Fehler, Alarm oder das Problem. Der Vertrag besagt, dass dieses Signal verstummt – kein neues Ereignis mit diesem Merkmal aus dieser Quelle mehr auftritt –, sobald die Änderung genügend Anfragen auf den betroffenen Pfaden bearbeitet hat und 24 Stunden lang still bleibt. Die Anfrage muss die Pfade und die Anzahl der Anfragen angeben; sehen Sie sich das signal Feld des Arbeitsaufnahme-Prozesses API.
  • Ohne messbare Kriterien. Fehlen Akzeptanzkriterien oder ein Signal mit Pfaden und Anzahl, wird der Vertrag endgültig und nicht messbar. Er gibt dies offen zu, statt so zu tun, als wäre es messbar.

Dies gilt für jede Aufgabe, einschließlich der Aufgaben, die Coroid selbst im Rahmen eines Plans, durch Automatisierungen oder zur Reparatur erstellt. Aufgaben, die vor Einführung der Verträge angelegt wurden, haben keinen Vertrag.

Vertrag abschließen und ändern

Ein Entwurf kann bearbeitet werden. Abschließen setzt ihn fest. Danach Neue Version speichert die Änderung als nächste Version und behält die vorherige bei, sodass Sie immer sehen können, was bei Beginn der Arbeit versprochen wurde.

Nur die Person, die die Arbeit angefordert hat, darf Verträge erstellen – oder, bei Arbeiten unter einem Auftrag, der Inhaber des Auftrags. Agenten und Dienstkonten können keine Verträge erstellen, bearbeiten oder abschließen.

Ergebnisse

Ein Vertrag endet mit einem von vier möglichen Ergebnissen:

ErgebnisBedeutung
VerifiziertDie Erfolgsbedingung wurde nach der erforderlichen Auswirkung und Zeitspanne erfüllt.
Nicht erfülltDas war nicht der Fall.
UnentschiedenDie Änderung erreichte nie eine ausreichende Auswirkung, um ein Urteil zu ermöglichen.
Nicht messbarNichts konnte gemessen werden.

Verträge und Zusammenführen

Ein Vertrag führt niemals zu einem Zusammenführen und blockiert auch kein Zusammenführen. Das Zusammenführen bleibt eine Entscheidung der Person, wie in Ergebnis rezensieren und zusammenführenbeschrieben. Der Vertrag dokumentiert, was mit diesem Zusammenführen erreicht werden sollte.