Architecture Decision Record

Active theme: Light

← dokumente

Empfehlungen für gute ADRs

Merkmale eines guten ADRs:

  • Begründung: Erklären Sie die Gründe für die jeweilige AD. Das kann den Kontext (siehe unten), Vor- und Nachteile verschiedener möglicher Optionen, Funktionsvergleiche, Kosten-Nutzen-Erörterungen und mehr umfassen.

  • Spezifisch: Jeder ADR sollte sich auf eine AD beziehen, nicht auf mehrere ADs.

  • Zeitstempel: Geben Sie an, wann jeder Punkt im ADR geschrieben wurde. Das ist besonders wichtig für Aspekte, die sich im Lauf der Zeit ändern können, wie Kosten, Zeitpläne, Skalierung und Ähnliches.

  • Unveränderlich: Ändern Sie keine vorhandenen Informationen in einem ADR. Ergänzen Sie den ADR stattdessen durch neue Informationen oder ersetzen Sie ihn durch einen neuen ADR.

Merkmale eines guten Abschnitts „Kontext“ in einem ADR:

  • Erklären Sie die Situation und die geschäftlichen Prioritäten Ihrer Organisation.

  • Beziehen Sie Begründungen und Überlegungen ein, die auf der sozialen und fachlichen Zusammensetzung Ihrer Teams beruhen.

  • Nennen Sie relevante Vor- und Nachteile und beschreiben Sie sie so, dass sie zu Ihren Bedürfnissen und Zielen passen.

Merkmale eines guten Abschnitts „Konsequenzen“ in einem ADR:

  • Erklären Sie, was aus der Entscheidung folgt. Das kann Auswirkungen, Ergebnisse, Ausgaben, Folgemaßnahmen und mehr umfassen.

  • Nennen Sie Informationen zu nachfolgenden ADRs. Es ist relativ üblich, dass ein ADR den Bedarf an weiteren ADRs auslöst, etwa wenn ein ADR eine große übergreifende Entscheidung trifft, die wiederum Bedarf an weiteren kleineren Entscheidungen schafft.

  • Beziehen Sie Nachbetrachtungsprozesse ein. Es ist üblich, dass Teams jeden ADR einen Monat später überprüfen, um die ADR-Informationen mit dem zu vergleichen, was in der Praxis geschehen ist, um zu lernen und zu wachsen.

Ein neuer ADR kann einen früheren ADR ersetzen:

  • Wenn eine AD getroffen wird, die einen früheren ADR ersetzt oder ungültig macht, sollte ein neuer ADR erstellt werden