Leichtgewichtige Architekturdokumentation

Training iSAQB® CPSA®-Advanced ADOC — 2 Tage

Technik
Methodik20
Kommunikation
Termine und Buchung

Beschreibung

Softwarearchitekturen festhalten und kommunizieren

Erstelle und pflege nachvollziehbare Architekturdokumentation. Wähle zielgerichtete Formate und Werkzeuge für eine optimale Balance von Aufwand und Nutzen.

Dokumentation als Ballast? Ein wirkungsvolles Festhalten der Architektur hilft dir beim Entwurf der Software, leitet die Umsetzung und führt zu einer nachvollziehbaren und bewertbaren Lösung. Angemessene Dokumentation unterstützt den Austausch im Team und gegenüber Dritten. In diesem interaktiven Workshop erfährst du, wie die Dokumentation der Architektur von der lästigen Pflicht zu einem integralen Kommunikations- und Arbeitsmittel wird. Lerne, architekturrelevante Einflussfaktoren und zentrale Entscheidungen prägnant festzuhalten. Und erlebe, wie eine plausible Softwarearchitektur entsteht.

Grundlage für das Seminar ist das Buch „Softwarearchitekturen dokumentieren und kommunizieren – Entwürfe, Entscheidungen und Lösungen nachvollziehbar und wirkungsvoll festhalten“ (Hanser Verlag, 3. Auflage) unseres Trainers Stefan Zörner. Das Buch ist für jeden Teilnehmer im Seminarpreis enthalten (Gebundene Ausgabe und eBook).

iSAQB ADOC Training

Agenda

  • Einstieg und Motivation: Welche Ziele verfolgst du mit Architekturdokumentation?

  • Minimaler Architekturüberblick: Was gehört hinein? Wie fertigst du einen an?

  • Zutaten einer Architekturdokumentation: Entscheidungen, Konzepte, Diagramme …

  • Gliederungen: Vorteile von Templates, arc42 und Alternativen

  • Vorgehen: Zielgruppen, Auswahl der Bestandteile, Dokumentieren vorher vs. danach

  • Werkzeugfrage: Gängige Optionen, deren Stärken und Schwächen, typische Herausforderungen

  • Dokumentation bewerten: Überprüfung auf Standardkonformität vs. Gebrauchstauglichkeit

Dein Nutzen

Sicherheit beim Festhalten von Lösungsansätzen

Vermeidung typischer Fallen, etwa bei Umfang und Detailtiefe

Ballastfreie Architekturüberblicke

Viele Vorlagen, Checklisten und Praxistipps

Austausch zu aktuellen Tool-Trends in Dokumentation

Zielgruppe

Dieser Workshop richtet sich an alle, die Softwarelösungen entwerfen und weiterentwickeln. Oder an ihrer Entstehung maßgeblich beteiligt sind, zum Beispiel in der Rolle eines Produktverantwortlichen. Die Teilnehmenden haben bereits praktische Erfahrungen in IT-Projekten gesammelt. Kenntnisse in einer bestimmten Technologie oder Programmiersprache sind nicht erforderlich. UML-Kenntnisse schaden nicht, sind aber keine zwingende Voraussetzung.

Lernziele

Ziele und Nutzen von Architekturdokumentation erklären

Umfang, Struktur und Vorgehen situativ passend bestimmen

typische Notations- und Darstellungsmittel kennen

Einflussfaktoren angemessen dokumentieren

aussagekräftige Abbildungen anfertigen

Entscheidungen nachvollziehbar festhalten

Werkzeuge und Formate bedarfsgerecht auswählen

Rückmeldungen zu Dokumentationsergebnissen geben

Deine Trainer:innen

Benjamin Wolf

INNOQ

Architekturdokumentation, Softwarequalität, Softwareentwicklungsprozess

  • CPSA Foundation-Level
  • Evolution und Verbesserung von Softwarearchitekturen
  • Leichtgewichtige Architekturdokumentation

Ben Wolf ist Architekt und Entwickler bei INNOQ. Er erträgt unsauberen Code nur schwer und scheut nicht vor umfangreichen Refactorings zurück. Seine Vorstellung von Softwarequalität gibt er als Sprecher bei Konferenzen und Meetups sowie in Trainings weiter. Dabei ist ihm wichtig, dass nicht (nur) Technologien, sondern vor allem die Einstellung eines Teams für eine gute Softwarequalität ausschlaggebend sind. Er ist zertifizierter Trainer für den iSAQB Foundation Level und die Advanced-Level-Module IMPROVE und ADOC. Ben ist Teil des iSAQB-Vorstandes.

Stefan Zörner

embarc

Architekturdokumentation, Methodische Softwarearchitektur und Cloud-Anwendungen

  • Architekturbewertung
  • CPSA Foundation-Level
  • Evolution und Verbesserung von Softwarearchitekturen
  • Flexible Architekturen
  • Leichtgewichtige Architekturdokumentation

Von der Bayer AG über IBM und oose zu embarc. Stefan Zörner blickt auf 20 Jahre IT-Erfahrung zurück und stets gespannt nach vorn. Er unterstützt in Architektur- und Umsetzungsfragen mit dem Ziel, gute Architekturansätze wirksam in der Implementierung zu verankern. In lebendigen Workshops vermittelt er Handwerkszeug dazu und steckt mit seiner Begeisterung an. Sein pragmatischer Ansatz Architektur festzuhalten findet großen Anklang.

Unsere Kund:innen sagen

Für viele Entwickler ist „Dokumentation“ zumeist ein recht trockenes Thema – dieses Klischee widerlegt Stefan Zörner in der ADOC-Schulung innerhalb von zwei Tagen (die wie im Flug vergangen sind) gründlich. Neben den üblichen Zutaten einer Architekturdokumentation und den gängigen Werkzeugen zur Erstellung solcher Dokumente, konnte ich vor allem meinem methodischen Werkzeugkasten um einiges erweitern. Und langweilig geworden ist mir (nicht zuletzt aufgrund Stefans lockerer Art und aufgrund des Austauschs mit den anderen Teilnehmern) nie – denn nicht jedes Klischee stimmt.

Martin Helmich, Head of Architecture & Developer Relations, mittwald Martin Helmich Head of Architecture & Developer Relations mittwald

Fachinfos und Bücher

Softwarearchitekturen dokumentieren und kommunizieren

Entwürfe, Entscheidungen und Lösungen nachvollziehbar und wirkungsvoll festhalten. Das Buch von Stefan Zörner zeigt, wie ihr die zentralen Lösungsansätze Eurer Softwaresysteme so festhalten könnt, dass sie Euch bei der Entwicklung und Weiterentwicklung helfen. Dabei betrachtet er sowohl die Situation, dass ihr ein neues Softwaresystem baut, als auch das „Nachdokumentieren“ bestehender Lösungen. Hanser Fachbuch, 3., überarbeitete und erweiterte Auflage (Dez 2021). Webseite zum Buch: swadok.de

Der Architekturüberblick (Architektur-Spicker Nr. 1)

Dir oder Deinem Team fehlt ein kompakter Überblick zu Eurer bestehenden Softwarelösung? Du möchtest einem neuen Projektmitglied oder einem Kooperationspartner Eure Architektur erklären? Der Quelltext ist zu »ausführlich« … Die erste Ausgabe unseres Architektur-Spickers unterstützt Euch dabei, die zentralen Lösungsansätze Eurer Softwarearchitektur nachvollziehbar darzustellen. Nutzt die kompakt erläuterten Zutaten und füllt Euren Architekturüberblick mit Leben – pragmatisch und wirkungsvoll zugleich. Download & Infos

arc42 by Example

Die Architektur von sechs realen Softwaresystemen, jeweils mit arc42 beschrieben. Dadurch können Sie anhand praktischer Beispiele sehen, wie sich arc42 anfühlt. Gerne genutzt, um die Einführung von arc42 in Teams oder Projekten zu unterstützen.

Softwarearchitekturen pragmatisch dokumentieren – Eine kompakte Einführung in arc42

Effektiv, schmerzfrei und mit wenig Aufwand. Gernot Starke und Benjamin Wolf räumen mit einigen Vorurteilen gegen (technische) Dokumentation auf und zeigen Dir, wie Du auf einfache Weise zu vernünftiger (Architektur-)Dokumentation kommst.

Online-Termine

Vor-Ort-Termine

Event-Ticketing-Software von pretix

Inhouse Training

Du kannst dieses Training auch als Inhouse-Training exklusiv für dein Team buchen. Bitte nutze dafür unser Anfrage-Formular.

Jetzt anfragen

Relevante weitere Trainings