Von der Idee zur Architektur: Ein praktischer Leitfaden zu UML, Diagram-as-Code und KI mit Visual Paradigm

Einführung

Softwarearchitektur ist leichter zu verstehen, zu kommunizieren und zu warten, wenn komplexe Anforderungen visuell dargestellt werden.UML-Diagramme, Architekturkarten, Prozessabläufe und Datenmodelle helfen Teams, sich vor Beginn der Implementierung abzustimmen. Traditionelle Diagrammerstellung kann jedoch langsam werden, wenn jedes Element manuell positioniert und von Hand aktualisiert werden muss.

Ein effizienterer Ansatz kombiniert drei Praktiken:

• UML-Modellierung für strukturierte Analyse und Gestaltung

• Diagram-as-Code (DaC)für versionierbare, wiederholbare Diagrammerstellung

• KI-Unterstützungzur Erstellung und Verfeinerung initialer Modelle

Visual Paradigmvereint diese Praktiken durch seine UML-Modellierungswerkzeuge, VPasCode-Plattform für Text-zu-Diagramm, KI-Funktionen zur Diagrammerstellung und Dokumentationsintegrationen. VPasCode unterstützt Diagrammsprachen und -formate wie PlantUML, Mermaid, Graphviz und andere textbasierte Notationen mit Live-Vorschau neben dem Quellcode.

Das Ergebnis ist ein Workflow, der von einer Idee in natürlicher Sprache zu einem bearbeitbaren Diagramm, dann zu einem formaleren Modell und einer teilbaren Projektdokumentation führt.

1. Verständnis des Visual-Paradigm-Werkzeug-Ökosystems

Visual Paradigm UML

Die UML-Werkzeuge von Visual Paradigm eignen sich für strukturierte Softwareanalyse und -gestaltung. Sie unterstützen gängige UML-Perspektiven wie:

• Anwendungsfalldiagramme

• Klassendiagramme

• Sequenzdiagramme

• Aktivitätsdiagramme

• Zustandsautomatendiagramme

• Komponentendiagramme

• Bereitstellungsdiagramme

• Kommunikationsdiagramme

UML ist besonders nützlich, wenn ein Team mehr als eine schnelle visuelle Skizze benötigt. Ein UML-Modell kann Systemstruktur, Verhalten, Verantwortlichkeiten, Abhängigkeiten und Interaktionen in einer konsistenten Notation beschreiben.

Ein Beispiel: Ein Klassendiagramm kann Folgendes definieren:

• Klassen und Schnittstellen

• Attribute und Operationen

• Vererbung

• Assoziationen

• Aggregation und Komposition

• Multiplizitäten

• Abhängigkeiten und Einschränkungen

VPasCode

VPasCode ist die browserbasierte Lösung von Visual Paradigm Diagramm-as-Code Arbeitsbereich. Anstatt Formen manuell zu platzieren, schreiben oder generieren Benutzer textbasierte Diagrammdefinitionen und sehen das gerenderte Ergebnis in Echtzeit. Es unterstützt PlantUML, Mermaid, Graphviz und andere unterstützte Formate.

Zu den Hauptfunktionen gehören:

• Quellcode und Diagrammvorschau nebeneinander

• Bearbeitung im Browser ohne lokale Einrichtung

• Mehrere Diagrammsprachen in einem Arbeitsbereich

• KI-gestützte Diagrammerstellung

• KI-gestützte Modifikation

• Korrektur von Syntaxfehlern

• Diagrammübersetzung

• Freigabe und Bildexport

VPasCode ist besonders nützlich für Entwickler, Architekten und technische Autoren, die Diagramme nahtlos in einen codezentrierten Workflow integrieren möchten.

KI-gestützte Diagrammerstellung

Die KI-Funktionen von Visual Paradigmkönnen Anweisungen in natürlicher Sprache in Diagrammcode umwandeln. Ein Benutzer kann beispielsweise ein Sequenzdiagramm für einen Login-Flow oder ein Klassendiagramm für einen Online-Shop anfordern. VPasCode kann dann Code in einem unterstützten Format generieren und das Ergebnis rendern.

KI kann auch dabei helfen, ein bestehendes Diagramm zu modifizieren. Anstatt das gesamte Skript neu zu schreiben, können Benutzer Anweisungen wie folgende erteilen:

• „Einen Zahlungsfehlerpfad hinzufügen.“

• „Einen Administrator-Akteur einführen.“

• „Die Dienste nach begrenztem Kontext gruppieren.“

• „Umbenennen „Bestellung bearbeiten zu Bestellung prüfen und bestätigen.”

• „Alle Beschriftungen ins Französische übersetzen.“

Erstellte Diagramme sollten als Arbeitsentwürfe behandelt werden. Die KI kann den Modellierungsprozess beschleunigen, aber Domänenexperten müssen weiterhin Beziehungen, Terminologie, Verantwortlichkeiten und Systemgrenzen überprüfen.

2. Schlüsselkonzepte

UML-Modellierung

UML ist eine standardisierte visuelle Sprache zur Beschreibung von Softwaresystemen. Verschiedene Diagrammtypen beantworten unterschiedliche Fragen:

Ein nützlicher Modellierungsprozess beginnt normalerweise mit einer hochleveligen Übersicht und fügt schrittweise Details hinzu. Zum Beispiel:

1. Akteure und Geschäftsziele identifizieren.

2. Wichtige Domänenkonzepte definieren.

3. Wichtige Interaktionen beschreiben.

4. Komponenten und Integrationen abbilden.

5. Dokumentation von Bereitstellungs- und Betriebsaspekten.

Diagramm als Code

Diagramm als Codestellt ein Diagramm als Text dar und nicht als Sammlung manuell positionierter Formen. Die Quelldatei wird zur bearbeitbaren Definition des Diagramms.

Ein kleines PlantUML-Beispiel:

@startuml

actor Kunde
participant "Web-App" as Web
participant "Bestelldienst" as Order
participant "Zahlungs-Gateway" as Payment

Kunde -> Web: Bestellung einreichen
Web -> Order: Bestellung erstellen
Order -> Payment: Zahlung autorisieren

alt Zahlung genehmigt
    Payment --> Order: Autorisierung erfolgreich
    Order --> Web: Bestellung bestätigt
else Zahlung abgelehnt
    Payment --> Order: Autorisierung fehlgeschlagen
    Order --> Web: Zahlungsfehler anzeigen
end

@enduml

Die Vorteile umfassen:

• Versionskontrolle:Diagramm-Quellcode in Git speichern.

• Überprüfbarkeit:Änderungen über Pull-Requests überprüfen.

• Wiederholbarkeit:Diagramme konsistent neu generieren.

• Automatisierung:Diagramme in Dokumentations-Pipelines einbeziehen.

• Wartbarkeit:Text aktualisieren statt viele Formen neu anzuordnen.

• Zusammenarbeit:Entwickler, Architekten und technische Autoren können mit vertrauten Textdateien arbeiten.

KI-gestütztes Modellieren

KI kann mehrere Phasen des Modellierungsprozesses unterstützen:

1. Erstellung:Erstellen Sie ein erstes Diagramm aus einer Beschreibung.

2. Änderung:Elemente hinzufügen, entfernen oder neu organisieren.

3. Korrektur:Syntaxprobleme beheben.

4. Übersetzung:Beschriftungen übersetzen, während die strukturelle Syntax erhalten bleibt.

5. Erklärung:Benutzern helfen, ungewohnten Diagrammcode zu verstehen.

KI ist am effektivsten, wenn Aufforderungen den Diagrammtyp, den Umfang, die Teilnehmer, die Beziehungen und das erwartete Detaillierungsgrad angeben.

3. Ein vollständiger Workflow mit Visual Paradigm

Phase 1: Das System beschreiben

Beginnen Sie mit einem kurzen architektonischen Überblick. Enthalten Sie:

• Der Zweck des Systems

• Hauptbenutzer

• Hauptdienste oder Module

• Externe Systeme

• Wichtige Geschäftsabläufe

• Wichtige Erfolgs- und Fehlschlagspfade

Zum Beispiel:

Erstellen Sie ein UML-Sequenzdiagramm für einen E-Commerce-Kaufabschlussprozess. Enthalten Sie Kunde, Webanwendung, Bestelldienst, Inventardienst, Payment-Gateway und Benachrichtigungsdienst. Zeigen Sie Szenarien für erfolgreiche Zahlung, abgelehnte Zahlung und unzureichenden Lagerbestand.

Dies ist effektiver als eine vage Anweisung wie „Erstellen Sie ein E-Commerce-Sequenzdiagramm“, da sie die erwarteten Teilnehmer und das Verhalten definiert.

Phase 2: Ein erstes Diagramm erstellen

Nutzen Sie die KI-Diagrammerstellungsfunktion in VPasCode oder beginnen Sie mit einem Visual Paradigm KI-Diagrammierungsworkflow. Das generierte Ergebnis bietet einen Ausgangspunkt und keine fertige architektonische Spezifikation.

Überprüfen Sie das Ergebnis in diesem Stadium auf:

• Fehlende Akteure oder Komponenten

• Falsche Beziehungen

• Mehrdeutige Bezeichnungen

• Unnötige Details

• Fehlende alternative Abläufe

• Falsche Annahmen bezüglich Geschäftsregeln

Das Ziel der KI-Generierung besteht darin, die Hemmschwelle bei der leeren Seite zu verringern und schnell einen nützlichen ersten Entwurf zu erstellen.

Phase 3: Verfeinern Sie das Diagramm in VPasCode

Öffnen Sie den generierten Quellcode in VPasCode und verfeinern Sie ihn direkt. VPasCode bietet eine Live-Vorschau, die es dem Autor ermöglicht, Codeänderungen mit dem visuellen Ergebnis zu vergleichen, während das Diagramm bearbeitet wird.

Eine praktische Verfeinerungssequenz ist:

1. Benennen Sie Elemente unter Verwendung der Projektterminologie um.

2. Entfernen Sie spekulative Komponenten.

3. Fügen Sie fehlende Fehlerpfade hinzu.

4. Klären Sie Beziehungen und Nachrichtenrichtungen.

5. Gruppieren Sie zusammengehörige Elemente.

6. Fügen Sie Kommentare hinzu, um ungewöhnliche Entscheidungen zu erläutern.

7. Wenden Sie ein konsistentes Styling an.

8. Stellen Sie sicher, dass das Diagramm in der beabsichtigten Größe lesbar bleibt.

Ein Beispiel: Ein von einer KI generiertes Sequenzdiagramm zeigt möglicherweise nur eine erfolgreiche Zahlung. Eine nachfolgende Anweisung könnte lauten:

Fügen Sie einen alternativen Ablauf für abgelehnte Zahlungen hinzu. Der Bestelldienst muss die Bestellung als “PaymentFailed"“, und die Webanwendung muss eine Wiederholungsmitteilung anzeigen. Ändern Sie nicht den bestehenden Ablauf für erfolgreiche Zahlungen.

VPasCode bietet auch eine KI-gestützte Syntaxkorrektur an, wenn ein PlantUML-, Mermaid- oder Graphviz-Skript nicht gerendert werden kann. Der empfohlene Prozess besteht darin, den gemeldeten Fehler zu überprüfen, die vorgeschlagene Korrektur anzuwenden und den geänderten Quellcode zu prüfen, bevor er akzeptiert wird.

Phase 4: Validieren Sie das Modell

Ein Diagramm kann syntaktisch gültig sein und dennoch architektonisch falsch sein. Validieren Sie es anhand der Anforderungen und Implementierungsannahmen.

Stellen Sie folgende Fragen:

• Hat jeder Akteur eine klare Verantwortung?

• Sind die Systemgrenzen explizit definiert?

• Sind die Beziehungen korrekt gerichtet?

• Sind die Multiplizitäten korrekt?

• Stimmen die Service-Aufrufe mit der beabsichtigten Architektur überein?

• Sind Fehlerpfade dargestellt?

• Zeigt das Diagramm zu viele Implementierungsdetails?

• Entsprechen die Namen der Codebasis und der Domänensprache?

Überprüfen Sie bei einem Klassendiagramm die Ownership und Kardinalität. Bei einem Sequenzdiagramm die Nachrichtenreihenfolge und Antworten. Bei einem Bereitstellungsdiagramm, dass die dargestellte Infrastruktur die tatsächliche Laufzeitumgebung widerspiegelt.

Phase 5: Weiterarbeit in den grafischen Modellierungstools von Visual Paradigm

Textbasierte Diagramme eignen sich hervorragend für schnelle Iterationen, eine grafische UML-Umgebung ist jedoch oft praktischer für das detaillierte Modellmanagement. Visual Paradigm unterstützt die Weiterarbeit über grafische Editoren, nachdem ein Diagramm generiert oder importiert wurde.

Verwenden Sie die grafische Modellierungsumgebung, wenn Sie Folgendes benötigen:

• Detaillierte Attribute und Operationen hinzufügen

• Datentypen definieren

• Sichtbarkeit und Eigenschaften festlegen

• Beziehungen verfeinern

• Größere Modelle organisieren

• Zusammenhängende Diagramme verbinden

• Ein umfassenderes Projektmodell pflegen

• Formale Dokumentation erstellen

Dies schafft eine praktische Arbeitsteilung:

• VPasCode:schnelle, textbasierte, codefreundliche Erstellung

• Visual Paradigm UML-Tools:detaillierte grafische Modellierung und strukturierte Verfeinerung

• OpenDocs oder Dokumentationswerkzeuge:Veröffentlichung und Wissensaustausch

Abgeschlossene Diagramme können auch an Visual Paradigm-Dokumentationsworkflows, einschließlich OpenDocs, angebunden werden, um teilbare Projekt-Wissensbasen zu erstellen.

Phase 6: Veröffentlichen und Pflegen der Dokumentation

Diagramme für die Verwendung in Folgendem exportieren:

• Architektur-Entscheidungsdokumente

• Technische Spezifikationen

• API-Dokumentation

• Design-Überprüfungen

• Einarbeitungsleitfäden

• Projekt-Wikis

• Präsentationen

• Release-Dokumentation

VPasCode unterstützt Exportformate wie PNG, SVG und PDF, sodass Diagramme sowohl in weborientierter als auch in druckorientierter Dokumentation verwendet werden können.

Wichtiger ist es, die ursprüngliche Diagrammquelle zu behalten. Exportierte Bilder sind Präsentationsprodukte; der Quellcode ist die wartbare Version.

4. Praktische Beispiele

Beispiel 1: Use-Case-Diagramm für einen Online-Shop

Ein Use-Case-Diagramm kann die Hauptziele eines Online-Shopping-Systems definieren:

@startuml

left to right direction

actor Customer
actor Administrator
actor "Payment Gateway" as Payment

rectangle "Online Store" {
    usecase "Browse Products" as Browse
    usecase "Manage Cart" as Cart
    usecase "Place Order" as PlaceOrder
    usecase "Authenticate User" as Authenticate
    usecase "Process Payment" as ProcessPayment
    usecase "Manage Catalog" as ManageCatalog
}

Customer --> Browse
Customer --> Cart
Customer --> PlaceOrder

PlaceOrder ..> Authenticate : <<include>>
PlaceOrder ..> ProcessPayment : <<include>>

Payment --> ProcessPayment
Administrator --> ManageCatalog

@enduml

Dieses Diagramm definiert die Systemgrenze und identifiziert die primären Akteure und Fähigkeiten. Es versucht nicht, jedes interne Implementierungsdetail zu erklären.

Beispiel 2: Klassendiagramm für Bestellungen

@startuml

class User {
    -id: UUID
    -email: String
    +placeOrder(): Order
}

class Order {
    -orderNumber: String
    -status: OrderStatus
    +calculateTotal(): Money
}

class OrderLine {
    -quantity: Integer
    -unitPrice: Money
}

class Product {
    -sku: String
    -name: String
    -price: Money
}

class Payment {
    -transactionId: String
    -status: PaymentStatus
}

User "1" --> "0..*" Order : places
Order "1" *-- "1..*" OrderLine
OrderLine "*" --> "1" Product
Order "1" --> "0..1" Payment

@enduml

Dieses Beispiel vermittelt Eigentumsverhältnisse und Kardinalitäten:

• Ein Benutzer kann viele Bestellungen aufgeben.

• Eine Bestellung enthält eine oder mehrere Positionszeilen.

• Jede Bestellposition bezieht sich auf ein einzelnes Produkt.

• Eine Bestellung kann null oder eine Zahlungsaufzeichnung haben.

Die genauen Beziehungen sollten anhand der Domänenregeln der Anwendung überprüft werden. Beispielsweise können einige Systeme mehrere Zahlungsversuche für eine Bestellung zulassen, in welchem Fall die Zahlungsbeziehung angepasst werden müsste.

Beispiel 3: Mermaid-Flussdiagramm für einen Genehmigungsprozess

flowchart TD
    A[Antrag einreichen] --> B{Betrag überschreitet Limit?}
    B -- Nein --> C[Automatisch genehmigen]
    B -- Ja --> D[Manager-Prüfung]
    D --> E{Genehmigt?}
    E -- Ja --> F[Kaufauftrag erstellen]
    E -- Nein --> G[Antrag ablehnen]
    C --> F

Mermaid kann für leichte Flussdiagramme und Dokumentationsseiten praktisch sein. PlantUML kann vorzuziehen sein, wenn das Team eine breitere UML-Abdeckung benötigt, während Graphviz für graphenorientierte Beziehungen und Netzwerkstrukturen nützlich sein kann.

5. Prompting-Techniken für bessere KI-generierte Diagramme

Diagrammtyp angeben

Geben Sie an, ob Sie Folgendes benötigen:

• Klassendiagramm

• Sequenzdiagramm

• Aktivitätsdiagramm

• Anwendungsfalldiagramm

• Komponentendiagramm

• Bereitstellungsdiagramm

• Zustandsdiagramm

• Flussdiagramm

Umfang definieren

Sagen Sie der KI, ob das Diagramm Folgendes darstellen soll:

• Das gesamte System

• Ein Geschäftsprozess

• Ein Dienst

• Eine einzelne Benutzerreise

• Eine hochstufige Architektur

• Eine detaillierte Implementierungsinteraktion

Benennen Sie die Teilnehmer

Listen Sie die Akteure, Dienste, Entitäten oder Infrastrukturknoten auf, die erscheinen müssen. Dies verringert die Wahrscheinlichkeit, dass wichtige Elemente übersehen oder durch generische Namen ersetzt werden.

Beschreiben Sie Beziehungen explizit

Verwenden Sie Anweisungen wie:

• „Ein Kunde besitzt mehrere Bestellungen.“

• „Der API-Gateway leitet Anfragen an den Bestelldienst weiter.“

• „Der Zahlungsdienst ruft einen externen Zahlungsanbieter auf.“

• „Die Bestellung enthält eine oder mehrere Bestellpositionen.“

Einschließen alternativer Pfade

Geben Sie für Verhaltensdiagramme Ausnahmen und Fehler an:

• Zahlung abgelehnt

• Authentifizierung fehlgeschlagen

• Lagerbestand nicht verfügbar

• Zeitüberschreitung

• Duplizierte Anfrage

• Manuelle Genehmigung erforderlich

Kontrollierte Detaillierung erforderlich

Nützliche Anweisungen umfassen:

Erstellen Sie ein Komponenten-Diagramm auf hoher Ebene. Schließen Sie keine Datenbanktabellen, Methodennamen oder Details auf Infrastrukturebene ein.

Oder:

Erstellen Sie ein detailliertes Sequenzdiagramm, das Anfrage, Antwort, Validierung, Persistenz und Fehlerbehandlung zeigt.

Fordern Sie die KI auf, die bestehende Struktur beizubehalten

Verwenden Sie bei der Änderung eines Diagramms Einschränkungen wie:

Fügen Sie einen Stornierungsfluss hinzu, ohne den bestehenden erfolgreichen Fluss zu ändern oder Teilnehmer umzubenennen.

Dies hilft, unbeabsichtigte Änderungen zu begrenzen.

6. Best Practices für Teams

Diagramm-Quellcode in der Versionsverwaltung behalten

Speichern Sie PlantUML-, Mermaid-, Graphviz- oder andere Quelldateien zusammen mit dem relevanten Anwendungs- oder Dokumentationsprojekt. Verwenden Sie aussagekräftige Namen wie:

docs/
  architecture/
    checkout-sequence.puml
    order-domain.puml
    deployment-overview.puml

Überprüfen Sie Diagrammänderungen über denselben Prozess, der für Quellcode verwendet wird.

Trennen Sie konzeptionelle und detaillierte Diagramme

Vermeiden Sie es, jedes Detail in ein einziges Diagramm zu zwängen. Pflegen Sie separate Ansichten für:

• Geschäftsfähigkeiten

• Domänenstruktur

• Service-Interaktionen

• Infrastruktur-Bereitstellung

• Betriebsprozesse

Ein prägnantes Diagramm ist in der Regel nützlicher als ein erschöpfendes.

Verwenden Sie eine konsistente Benennung

Wählen Sie eine einheitliche Vokabular für Akteure, Services, Entitäten und Operationen. Wechseln Sie beispielsweise nicht zwischen:

• Bestellservice

• Bestellungs-Service

• Einkaufsservice

es sei denn, es handelt sich tatsächlich um unterschiedliche Komponenten.

Behandeln Sie KI-Ausgaben als Entwurf

KI kann plausible, aber falsche Beziehungen erzeugen. Überprüfen Sie:

• Kardinalitäten

• Vererbung

• Abhängigkeiten

• Sequenzreihenfolge

• Sicherheitsgrenzen

• Fehlerbehandlung

• Datenbesitz

Der menschliche Modellierer bleibt für die technische Genauigkeit des Endergebnisses verantwortlich.

Bewahren Sie die Quelle der Wahrheit

Nehmen Sie Änderungen nicht nur an einem exportierten Bild vor. Aktualisieren Sie die Diagrammquelle und generieren Sie das visuelle Artefakt neu. Dies verhindert, dass die Dokumentation von ihrer bearbeitbaren Definition getrennt wird.

Wählen Sie die richtige Diagrammsprache

Verwenden Sie PlantUML, wenn Sie umfangreiche UML-Unterstützung benötigen. Verwenden Sie Mermaid, wenn Diagramme in Markdown-orientierter Dokumentation eingebettet werden sollen. Verwenden Sie Graphviz, wenn die Graphenlayout und Knotenbeziehungen im Vordergrund stehen. VPasCode ermöglicht die Bearbeitung dieser Formate in einer einheitlichen Umgebung.

7. Häufige Fehler, die vermieden werden sollten

Beginnen mit zu vielen Details

Ein erstes Diagramm, das jede Klasse, jeden Endpunkt, jede Datenbanktabelle und jeden Infrastrukturknoten enthält, ist schwer zu überprüfen. Beginnen Sie mit den wichtigsten Konzepten und erstellen Sie anschließend fokussierte Folge-Diagramme.

Diagramm-Gültigkeit mit Modell-Gültigkeit verwechseln

Ein Diagramm kann erfolgreich gerendert werden, obwohl es ein falsches Design darstellt. Validieren Sie das Ergebnis stets anhand der Anforderungen und der Implementierungsrealität.

KI ohne Einschränkungen verwenden

Prompts wie „Entwerfen Sie mein gesamtes System” erzeugen meist einen inkonsistenten Umfang und unnötige Annahmen. Definieren Sie die Akteure, Grenzen, den Diagrammtyp und den erwarteten Detaillierungsgrad.

Abstraktionsebenen vermischen

Vermeiden Sie es, Geschäftsakteure, Java-Klassen, Cloud-Regionen und Datenbankspalten in dasselbe hochstufige Diagramm aufzunehmen, es sei denn, der Zweck erfordert dies ausdrücklich.

Fehlerszenarien vernachlässigen

Ein Sequenzdiagramm, das nur den Happy-Path darstellt, kann die wichtigsten Designentscheidungen verschleiern. Fügen Sie relevante Szenarien wie abgelehnte Zahlungen, nicht verfügbare Lagerbestände, Timeouts, Wiederholungsversuche und Autorisierungsfehler ein.

Fazit

Kombination von UML, Diagram-as-Code, und KIschafft einen praxisnahen Modellierungsworkflow für moderne Softwareteams. KI reduziert den Aufwand für die Erstellung eines ersten Entwurfs, VPasCodebietet eine schnelle textbasierte Bearbeitung und Live-Rendering, und UML-Tools von Visual Paradigmunterstützen eine tiefgehende Verfeinerung und eine strukturierte Modellentwicklung.

Ein produktiver Workflow ist:

1. Beschreiben Sie das System in natürlicher Sprache.

2. Erstellen Sie ein erstes Diagramm mit KI.

3. Verfeinern Sie das Diagramm als Code in VPasCode.

4. Validieren Sie das Modell anhand der Anforderungen.

5. Führen Sie die detaillierte Arbeit in der grafischen UML-Umgebung von Visual Paradigm fort.

6. Veröffentlichen Sie das Ergebnis als wartbare Projektdokumentation.

7. Speichern Sie die Quelle unter Versionskontrolle und aktualisieren Sie sie, während sich das System weiterentwickelt.

In Kombination verwandeln diese Tools die Architektur-Dokumentation von einer einmaligen Zeichenübung in eine wiederholbare Ingenieurspraxis – eine, die schneller zu aktualisieren, einfacher zu überprüfen und besser auf die von ihr beschriebene Software abgestimmt ist.

Der Artikel ist auch in English, Español, فارسی, Français and English verfügbar.