Leichtgewichtige Architekturdokumentation

Training iSAQB® CPSA®-Advanced ADOC — 2 Tage

Technik
Methodik20
Kommunikation
Termine und Buchung

Beschreibung

Softwarearchitekturen festhalten und kommunizieren

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

Teilnehmer:innen Bewertung

(24 Bewertungen)

97% aller Teilnehmer:innen würden dieses Training weiterempfehlen

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

Stefan Zörner

embarc

Architekturdokumentation, Methodische Softwarearchitektur und Cloud-Anwendungen

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.

Benjamin Wolf

INNOQ

Architekturdokumentation, Softwarequalität, Softwareentwicklungsprozess

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.

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