Architektur zielgruppengerecht kommunizieren und effektiv dokumentieren

Auch in komplexen Projekten behalten Sie den Überblick. Während der Weiterbildung lernen Sie, Softwarearchitekturen effektiv zu dokumentieren, zielgruppengerecht zu bewerten und zu kommunizieren. Die Schulung vermittelt neben fachlichen Aspekten auch die wesentlichen organisatorischen und sozialen Faktoren der Architekturdokumentation.
Die Bedeutung einer guten Architekturdokumentation wird in neuen IT-Projekten oft unterschätzt. Dabei hilft die Dokumentation der Softwarearchitektur entscheidend dabei, Entwicklungen und Änderungen während des Projekts nachzuvollziehen. Sie unterstützt zudem die Kommunikation innerhalb des Projektteams sowie mit Kunden und Partnern. Dadurch wird auch der Entwurf des Softwaresystems erleichtert.

Im Modul „ADOC“ des iSAQB Advanced Levels lernen Sie praxisorientiert, Architekturdokumentationen zu erstellen, zu optimieren und die Qualität zu sichern. Sie erwerben Kenntnisse in Notationen, Werkzeugen und Methoden zur Dokumentation von Architekturentscheidungen und Qualitätsanforderungen und können passende Werkzeuge auswählen. Am Ende sind Sie in der Lage, Architekturdokumentationen für mittlere bis große IT-Systeme zu erstellen.

Voraussetzungen der Teilnehmenden

➤ Sie sollten Grundlagenwissen aus dem CPSA-F (z. B. Sichten, Entwurfsentscheidungen, Randbedingungen) mitbringen.
➤ Idealerweise haben Sie bereits Erfahrung in der Erstellung und Pflege technischer Dokumentationen.
➤ Sie verfügen über ein grundlegendes Verständnis typischer Herausforderungen wie der Auswahl von Notationen und der Integration von Werkzeugen.
➤ Erfahrungen in der Zusammenarbeit bei der Dokumentation sind von Vorteil.
➤ Kenntnisse in Versionierung und Dokumentationsprozessen erleichtern Ihnen den Einstieg.

Es gibt keine speziellen Anforderungen an die Schulungsumgebung, da die Übungen mit Cloud- und Web-basierten Tools wie Miro, Draw.io und Plattformen wie Jupyter oder HuggingFace stattfinden, hier wird nur eine stabile und ausreichend schnelle Internetverbindung benötigt.

Ihr Mehrwert

➤ Sie lernen, Softwarearchitekturen systematisch zu dokumentieren.
➤ Sie können bestehende Dokumentationen bewerten und gezielt verbessern.
➤ Sie berücksichtigen unterschiedliche Bedürfnisse und passen die Dokumentation entsprechend an.
➤ Sie nutzen Werkzeuge und Templates (z. B. arc42, C4) zur effizienten Erstellung.
➤ Sie erhalten praxisnahe Beispiele und Techniken zur Bewältigung realer Herausforderungen.
➤ Sie verwenden Reviews und Feedback, um die Dokumentationsqualität zu erhöhen.

✔️ Grundbegriffe von Softwarearchitekturdokumentation
➤ Nutzen, Ziele und Stakeholder-Anforderungen.
➤ Notationen (UML, BPMN) und Einfluss von Entwicklungsmethoden.
✔️ Dokumentation und Vorgehen
➤ Strukturierung und Erstellung von Architekturdokumentationen.
➤ Standardisierte Vorlagen (arc42, C4, IEEE 1471).
✔️ Bestandteile von Architekturdokumentationen
➤ Architekturentscheidungen, Architektursichten, Qualitätsanforderungen.
➤ Konsistenz und Nachvollziehbarkeit der Dokumentation.

✔️ Werkzeuge
➤ Analoge und digitale Werkzeuge zur Dokumentation.
➤ Modellierungswerkzeuge, Wikis, Versionskontrolle, Textverarbeitung.
✔️ Bewertung der Dokumentation
➤ Review-Methoden, Checklisten, Qualitätssicherung.
✔️ Beispiele für Dokumentation von Softwarearchitekturen
➤ Vorstellung und Analyse realer Architekturdokumentationen.
➤ Vergleich unterschiedlicher Dokumentationsansätze.
➤ Diskussion von Vor- und Nachteilen verschiedener Dokumentationsmethoden.

➤ Strukturierte und effiziente Dokumentation: Klare und nachvollziehbare Architekturaufzeichnungen für alle Stakeholder.

➤ Qualitätssteigerung: Verbesserte Konsistenz und Nachvollziehbarkeit durch bewährte Methoden und Werkzeuge.

➤ Optimierte Zusammenarbeit: Einheitliche Dokumentationsstandards erleichtern die Teamkommunikation und Abstimmung.