Seminar Mermaid Barrierefreiheit, Sicherheit und Governance

Seminarprofil: Diagramme werden barrierearm, sicher und nach einheitlichen Organisationsregeln erstellt, geprüft und freigegeben. Die Inhalte werden anhand eines durchgängigen Fachszenarios schrittweise aufgebaut, unmittelbar geprüft und in einem zusammenhängenden Praxisprojekt angewendet.

Inhaltsübersicht

Inhaltsverzeichnis dieses Kapitels: Seminarprofil, Zielsetzung, Zielgruppe, Voraussetzungen, Seminarinhalte, Praxisprojekt und Arbeitsmethoden.

1. Zielsetzung und Kompetenzaufbau
2. Zielgruppe und fachliche Einordnung
3. Voraussetzungen und Arbeitsumgebung
4. Schrittweise Seminarinhalte nach Tagen
5. Durchgängiges Praxisprojekt
6. Arbeits- und Prüfmethoden

Zielsetzung

Inhaltsverzeichnis dieses Kapitels: Fachkompetenz, Umsetzungskompetenz, Qualitätskontrolle und nachhaltige Pflege.

Nach der Bearbeitung können die behandelten Mermaid-Funktionen nicht nur syntaktisch verwendet, sondern fachlich begründet ausgewählt und in einen geregelten Dokumentationsprozess eingebettet werden. Im Mittelpunkt stehen folgende Kompetenzen:

• Zugängliche Titel und Beschreibungen formulieren
• Kontrast, Lesereihenfolge und Informationsdichte prüfen
• Sicherheitsstufen und vertrauenswürdige Inhalte unterscheiden
• Governance-Regeln und Freigabeprüfungen etablieren

Zielgruppe

Inhaltsverzeichnis dieses Kapitels: Geeignete Rollen, typische Aufgabenstellungen und gemeinsamer Anwendungskontext.

Technische Redaktion, Webentwicklung, Qualitätsmanagement, Informationssicherheit, Plattformteams und Verantwortliche für Dokumentationsstandards. Das Seminar ist auf die gemeinsame Bearbeitung realer Modellierungs- und Dokumentationsaufgaben ausgerichtet.

Voraussetzungen

Inhaltsverzeichnis dieses Kapitels: Fachwissen, technische Vorkenntnisse und benötigte Arbeitsmittel.

Sichere Bedienung grundlegender Mermaid-Syntax und Verständnis des eigenen Veröffentlichungsprozesses. Für die Übungen wird eine textbasierte Arbeitsumgebung mit Vorschau verwendet; alle Arbeitsschritte bleiben auch ohne spezielle Vorerfahrungen nachvollziehbar.

Seminarinhalte

Inhaltsverzeichnis dieses Kapitels: Tag 1: Barrierearme Diagramme gestalten, Tag 2: Sicherheitsmodell und organisatorische Regeln.

Tag 1: Barrierearme Diagramme gestalten

Inhaltsverzeichnis dieses Kapitels: Zugängliche Titel mit accTitle formulieren, Ausführliche Beschreibungen mit accDescr ergänzen, Kontrast und Farbbedeutung unabhängig gestalten, Lesereihenfolge und Informationsdichte prüfen, Textliche Ersatzdarstellungen vorbereiten.

Der erste Tag behandelt semantische Beschreibungen, visuelle Lesbarkeit und nachvollziehbare Alternativen für unterschiedliche Nutzungssituationen. Jeder Themenbaustein wird zunächst fachlich eingeordnet, anschließend im Code umgesetzt und danach anhand definierter Qualitätskriterien kontrolliert.

1. Schritt 1: Zugängliche Titel mit accTitle formulieren
   Zunächst werden Zweck, Begriffe und notwendige Abgrenzungen geklärt. Danach entsteht eine kleine, überprüfbare Grundfassung im Mermaid-Code. Die Aussage wird gegen das zugrunde liegende Fachszenario geprüft.
   Praxisaufgabe: Für den Baustein „Zugängliche Titel mit accTitle formulieren“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
2. Schritt 2: Ausführliche Beschreibungen mit accDescr ergänzen
   Die Grundstruktur wird schrittweise erweitert. Jede Änderung wird unmittelbar gerendert und auf Syntax, Beziehungsaussage und unerwünschte Nebenwirkungen kontrolliert.
   Praxisaufgabe: Für den Baustein „Ausführliche Beschreibungen mit accDescr ergänzen“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
3. Schritt 3: Kontrast und Farbbedeutung unabhängig gestalten
   Das Modell wird um realistische Varianten, Ausnahmen und Detailinformationen ergänzt. Dabei bleibt sichtbar, welche Information für die jeweilige Zielgruppe notwendig ist und welche besser ausgelagert wird.
   Praxisaufgabe: Für den Baustein „Kontrast und Farbbedeutung unabhängig gestalten“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
4. Schritt 4: Lesereihenfolge und Informationsdichte prüfen
   Mehrere Darstellungsvarianten werden verglichen. Lesbarkeit, semantische Eindeutigkeit, Wartbarkeit und stabile Ausgabe bilden die verbindlichen Auswahlkriterien.
   Praxisaufgabe: Für den Baustein „Lesereihenfolge und Informationsdichte prüfen“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
5. Schritt 5: Textliche Ersatzdarstellungen vorbereiten
   Der Baustein wird in einen wiederverwendbaren Arbeitsprozess überführt. Benennung, Ablage, Prüfung und spätere Änderung werden so festgelegt, dass das Diagramm dauerhaft gepflegt werden kann.
   Praxisaufgabe: Für den Baustein „Textliche Ersatzdarstellungen vorbereiten“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.

Tagesaufgabe: Ein vorhandenes Diagramm auf Barrieren prüfen und mit Beschreibung, Kontrastregeln und reduzierter Informationsdichte überarbeiten.

Tag 2: Sicherheitsmodell und organisatorische Regeln

Inhaltsverzeichnis dieses Kapitels: Sicherheitsstufen und ihre Wirkung unterscheiden, Vertrauenswürdige und fremde Eingaben trennen, Konfigurationen zentral und nachvollziehbar verwalten, Prüfregeln für Code, Inhalt und Ausgabe definieren, Freigabe, Versionierung und Ausnahmeverfahren festlegen.

Der zweite Tag verbindet technische Konfiguration mit verbindlichen Prüf-, Rollen- und Freigaberegeln. Jeder Themenbaustein wird zunächst fachlich eingeordnet, anschließend im Code umgesetzt und danach anhand definierter Qualitätskriterien kontrolliert.

1. Schritt 1: Sicherheitsstufen und ihre Wirkung unterscheiden
   Zunächst werden Zweck, Begriffe und notwendige Abgrenzungen geklärt. Danach entsteht eine kleine, überprüfbare Grundfassung im Mermaid-Code. Die Aussage wird gegen das zugrunde liegende Fachszenario geprüft.
   Praxisaufgabe: Für den Baustein „Sicherheitsstufen und ihre Wirkung unterscheiden“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
2. Schritt 2: Vertrauenswürdige und fremde Eingaben trennen
   Die Grundstruktur wird schrittweise erweitert. Jede Änderung wird unmittelbar gerendert und auf Syntax, Beziehungsaussage und unerwünschte Nebenwirkungen kontrolliert.
   Praxisaufgabe: Für den Baustein „Vertrauenswürdige und fremde Eingaben trennen“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
3. Schritt 3: Konfigurationen zentral und nachvollziehbar verwalten
   Das Modell wird um realistische Varianten, Ausnahmen und Detailinformationen ergänzt. Dabei bleibt sichtbar, welche Information für die jeweilige Zielgruppe notwendig ist und welche besser ausgelagert wird.
   Praxisaufgabe: Für den Baustein „Konfigurationen zentral und nachvollziehbar verwalten“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
4. Schritt 4: Prüfregeln für Code, Inhalt und Ausgabe definieren
   Mehrere Darstellungsvarianten werden verglichen. Lesbarkeit, semantische Eindeutigkeit, Wartbarkeit und stabile Ausgabe bilden die verbindlichen Auswahlkriterien.
   Praxisaufgabe: Für den Baustein „Prüfregeln für Code, Inhalt und Ausgabe definieren“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.
5. Schritt 5: Freigabe, Versionierung und Ausnahmeverfahren festlegen
   Der Baustein wird in einen wiederverwendbaren Arbeitsprozess überführt. Benennung, Ablage, Prüfung und spätere Änderung werden so festgelegt, dass das Diagramm dauerhaft gepflegt werden kann.
   Praxisaufgabe: Für den Baustein „Freigabe, Versionierung und Ausnahmeverfahren festlegen“ wird eine eigene Variante erstellt, gerendert, mit mindestens einer Alternative verglichen und anhand der Seminarkriterien überarbeitet.

Tagesaufgabe: Eine Organisationsrichtlinie mit Sicherheitsprofil, Rollenmodell, Prüfliste und Freigabeschritten entwickeln.

Praxisprojekt

Inhaltsverzeichnis dieses Kapitels: Aufgabenanalyse, Modellierungsentscheidung, schrittweise Umsetzung, Prüfung und dokumentierter Endstand.

Ein barrierearmes und sicher konfiguriertes Diagrammpaket einschließlich Governance-Regelwerk und dokumentierter Freigabeprüfung. Das Projekt wird in klar abgegrenzte Arbeitsschritte zerlegt. Nach jedem Schritt werden Syntax, fachliche Aussage, visuelle Lesbarkeit und spätere Änderbarkeit kontrolliert. Der Endstand enthält neben den Diagrammen auch Benennungs-, Struktur- und Prüfregeln.

Arbeitsmethoden

Inhaltsverzeichnis dieses Kapitels: Demonstration, angeleitete Umsetzung, Variantenvergleich, Fehleranalyse und eigenständige Vertiefung.

Kurze fachliche Einführungen wechseln mit Live-Demonstrationen und unmittelbar anschließenden Übungen. Komplexe Diagramme werden nicht als fertige Lösung präsentiert, sondern in kleinen, prüfbaren Änderungen aufgebaut. Varianten werden gegeneinander bewertet; typische Fehlbilder werden bewusst erzeugt, eingegrenzt und korrigiert. Das Praxisprojekt verbindet alle Kapitel zu einem konsistenten Arbeitsstand.