iSAQB CPSA-Advanced Architekturdokumentation (ADOC)

Im Seminar werden die folgenden Themen vorgestellt und eingehend behandelt:

Grundbegriffe von Softwarearchitektur-Dokumentation

• Den Nutzen und die verschiedenen Ziele von Architekturdokumentation
• Maßgebliche Nutzer und die Bedeutung von Architekturdokumentation für sie
• Architekturdokumentation vs. Dokumentation anderer Disziplinen (Anforderungsmanagement, Projektmanagement, …)
• Typische Notationen für Architekturdokumentation
• Konsequenzen veschiedener Vorgehensmodelle auf die Architekturdokumentation

Einbettung der Dokumentation in das Entwicklungs-Vorgehen

• Architekturdokumentation für neue Systeme, für existierende Systeme und für bisher undokumentierte Systeme
• Ermittlung der Zielgruppe und Ziele der Dokumentation
• bedarfsgerechte Auswahl der zu erstellenden Bestandteile
• Die Vorteile fester Gliederungen und Strukturen für Dokumentation
• Bestandteile von Architekturdokumentation

Bestandteile von Architekturdokumentation

• Die Architektur mittlerer bis großer IT-Systeme selbständig dokumentieren, sowohl entwicklungsbegleitend, wie bei Bedarf auch a posteriori („Nachdokumentation“)
• Vorhandene Architekturdokumentation weiterentwickeln und pflegen, dabei die Qualität der Dokumentation systematisch verbessern
• Für mittlere bis große Systeme spezifisch geeignete Arten und Strukturen der Architekturdokumentation erarbeiten oder auswählen
• Faktoren, die Einfluss auf Software-Architektur haben, identifizieren und geeignet dokumentieren, z. B. Randbedingungen, Qualitätsziele,  Technische Risiken
• Architekturentscheidungen nachvollziehbar festhalten
• Unterschiedliche Sichten auf Software-Architektur mit geeigneten Beschreibungsmitteln anfertigen
• Verschiedene Aspekte von Bausteinsichten erklären und dokumentieren (Darstellung als hierarchische Verfeinerung, Dokumentation wiederkehrender Strukturen oder Muster, Beschreibung interner Schnittstellen, Zusammenhang von Bausteinen zu Quellcode)
• Laufzeitszenarien, insbesondere zur Erfüllung der wesentlichen Systemfunktionen
• Darstellung über verschiedene Verfeinerungsebenen
• Notationen (etwa: UML, SysML o. ä.) zur Beschreibung von Sichten
• Schnittstellen beschreiben
• Technische und/oder übergreifende Konzepte zielgruppengerecht dokumentieren
• Konsistenz zwischen unterschiedlichen Bestandteilen der Architekturdokumentation prüfen bzw. herstellen
• Bestandteile in Dokumenten strukturieren

Werkzeuge (Tool Chains)

• Die richtigen Werkzeuge für die verschiedenen Aktivitäten auswählen:
  • Erstellung und Pflege von Bestandteilen von Architekturdokumentation
  • Verwaltung der Bestandteile
  • Kommunikation von Inhalten mit Unterstützung der Bestandteile
  • Analoge und digitale Dokumentationswerkzeuge situations- und bedarfsgerecht einsetzen
  • Eine vollständige Toolkette zur Architekturdokumentation anhand konkreter Anforderungen, Randbedingungen und weiterer Einflussfaktoren nachvollziehbar auswählen

Dokumentation bewerten

• Zwischen inhaltlicher und formaler Begutachtung einer Architekturdokumentation
  differenzieren
• Review einer Dokumentation von der Bewertung der Architektur abgrenzen
• Unterschiedliche Ziele beim Review der Dokumentation erklären
• Angemessene Review-Schritte auswählen, planen und durchführen
• Ziele für ein Review festlegen und verbindlich an die Gutachter kommunizieren
• Checklisten und Fragenkataloge für Reviews erstellen
• Im Rahmen einer Review-Sitzung
  • In der Rolle des Autors mit Einwänden angemessen umgehen
  • In der Rolle eines Gutachters konstruktive Rückmeldungen an Autoren geben
  • In der Rolle des Moderators ein Review leiten

Vorteile

• Erfahrener und akkreditierter Trainer:
  • Der Trainer ist akkreditiert und aktives Mitglied bei der iSAQB-Organisation. Darüber hinaus verfügt er über mehrjährige Erfahrung sowie fundiertes Wissen im Bereich Software-Architektur.
• Interaktive, praxisorientierte Ausbildung:
  • Die Teilnehmer erleben eine interaktive Schulung mit praxisbezogenen Übungen, die nach Ansicht ehemaliger Teilnehmer, das Erlernte vertiefen.
  • Der theoretische Inhalt wird durch die praktische Erfahrung des Trainers ergänzt, um sicherzustellen, dass die Kursteilnehmer nicht nur die relevanten Methoden, sondern auch die realen Herausforderungen ihrer Umsetzung verstehen.
  • Aktive Teilnahme und Diskussionen sind ausdrücklich erwünscht.
• Industriestandard-Zertifizierungen:
  • Anerkannter Qualifikationsnachweis und Anerkennung von Fachwissen
• Zwei kostenlose Coachingsitzungen*:
  • Die KursteilnehmerInnen erhalten zwei kostenlose Coachingsitzungen im Wert von 300 €, die sie dabei unterstützen, das Erlernte erfolgreich in ihren aktuellen Projekten umzusetzen.

Überblick

Die Albion Academy ist für ihre interaktiven Trainings mit Workshop-Charakter bekannt. Dies gilt auch für die Live-Online-Trainings von Albion, in denen die aktive Teilnahme der KursteilnehmerInnen an Diskussionen und an der Gruppenarbeit gefördert wird.

Durch den Einsatz der neuesten Online-Kollaborationswerkzeuge, wie z.B. Online-Whiteboards, erleben Sie eine präsenzähnliche Teilnahme. Während des Live-Online-Trainings arbeiten die TeilnehmerInnen zusammen, um gemeinsam praxisorientierte Übungen und Fallstudien durchzuführen, was zu einem tieferen Verständnis des Kursmaterials führt.
 

Vorteile des Live-Online-Trainings

• Niedrigerer Preis 
  • Niedriger Preis für das Live-Online-Training im Vergleich zum entsprechenden Präsenz-Training.
• Keine Reise- oder Hotelkosten
  • Effiziente Nutzung Ihrer Zeit
• Einhaltung von möglichen Reisebeschränkungen
  • Sie können bequem von jedem Standort aus teilnehmen, ohne reisen zu müssen.
• Die gleichen Frage- und Diskussionsmöglichkeiten
  • Wie bei einem Präsenz-Training ist die aktive Beteiligung der Teilnehmer erwünscht.
• Teilnehmer Zusammenarbeit
  • Die TeilnehmerInnen können während und nach dem Kurs über einen Online-Chat 24 Stunden am Tag Fragen an andere Teilnehmer und an den Trainer stellen (z.B. um Testfragen, aktuelle Projekt-Herausforderungen usw. zu besprechen).

Voraussetzungen für das Live-Online-Training

• Computer mit einer stabilen und schnellen Internetverbindung, die eine kontinuierliche Videoübertragung unterstützt.
• Geeignete Webcam.
• Headset anstelle des eingebauten Mikrofons, damit Umgebungsgeräusche reduziert werden.
• Moderner Web-Browser mit guter Javascript-Unterstützung.
• Ein ausreichend großer Monitor, um die Kursfolien, ein Whiteboard und andere Teilnehmer zu sehen. Weitere optionale Empfehlungen sind ein zweiter Monitor und ein Touchscreen mit einem Stift, um bspw. auf einem virtuellen Whiteboard zu zeichnen.
• Das Recht, auf dem eigenen Computer Software zu installieren, z. B. Microsoft-Teams.
  • Die Anwendungen sind auch über einen Webbrowser verfügbar, allerdings mit eingeschränkter Funktionalität.
• Die Anwesenheit der Teilnehmer ist verpflichtet, um eine Teilnahmebescheinigung zu bekommen.
• Nur eine Person pro Computer, kein Teilen von Computern.
• Planen Sie bitte ein, dass Sie ungestört von Kollegen, Familienmitgliedern, Haustieren usw. teilnehmen können.