In diesem praxisorientierten Hands-on Training lernen Sie, unter praktischen Randbedingungen (Zeit- und Kostendruck) angemessene Dokumentation für verschiedene Zielgruppen zu erstellen und zu pflegen.
ADOC hilft Ihnen, Ihre Architekturdokumentation in kürzester Zeit zu verbessern. Im Workshop arbeiten Sie an der Dokumentation ihrer eigenen Systeme, auf Wunsch stellen wir zusätzliche Fallbeispiele bereit. Sie dokumentieren mit Hilfe verschiedener Architektursichten (Kontext-, Baustein-, Laufzeit- und Deploymentsicht) sowie querschnittlicher Konzepte und Architekturentscheidungen und adressieren damit unterschiedliche Stakeholder.
Praktische Übungen
Sie erarbeiten anhand praktischer Übungen die wesentlichen Bestandteile hilfreicher Architekturdokumentation, insbesondere:
- Prägnante Formulierung von Aufgabenstellung
- Konkretisierung wesentlicher Qualitätsanforderungen
- Kontextabgrenzung mit externen Schnittstellen
- Bausteinsicht mit Verfeinerungen
- Laufzeitszenarien zur Erklärung von Bausteinen
- Infrastruktur und Deployment
- Erklärung querschnittlicher Konzepte
- Prägnante Dokumentation von Architekturentscheidungen mit Hilfe von Architecture Decision Records.
Priorisierung und Schwerpunktsetzung erfolgt in Abstimmung mit den Teilnehmenden. Für die praktischen Übungen ist ein Laptop hilfreich, aber nicht unbedingt notwendig.
Inhalt
- Grundlagen von Dokumentation
- Wesentliche Bestandteile effektiver Dokumentation
- Kontextabgrenzung und Architektursichten erklären
- Querschnittliche Konzepte erklären
- Entscheidungen systematisch dokumentieren mit Architecture Decision Records
- Werkzeuge zur Dokumentation
Inklusive ausführliche Trainings- und Übungsunterlagen sowie unseren Büchern „arc42 in Aktion“ und „arc42 by Example“.