Seminar Antora

Beschreibung

Das Portfolio deckt den vollständigen Lebenszyklus einer Antora-basierten Dokumentationsplattform ab: fachliche Einsatzplanung, AsciiDoc-Authoring, Content-Architektur, Playbooks, Git-Quellen, Navigation, Ressourcen-IDs, UI, Suche, Erweiterungen, Automatisierung, Betrieb, Sicherheit, Migration, Mehrformatausgabe und kontinuierliche Wartung.

Die Formate sind nach klar abgegrenzten Lernzielen dimensioniert. Eintägige Entscheidungsmodule konzentrieren sich auf Architektur und Planung. Zweitägige Fachseminare verbinden Konzept und vollständige Praxisstrecke. Drei- und viertägige Formate decken integrations- oder entwicklungsintensive Themen ab. Das fünftägige Intensivformat bündelt das Gesamtprogramm in verdichteter Form.

Inhaltsübersicht

1. Portfolio und Themenfelder
2. Empfohlene Besuchsreihenfolge
3. Rollenbasierte Lernpfade
4. Kompakt- und Intensivformate
5. Auswahl nach Projektphase
6. Dauerlogik der Formate

Portfolio und Themenfelder

• Einstieg und Planung: Einsatzarchitektur, Installation und Pilotierung.
• Inhalt und Informationsarchitektur: AsciiDoc, Komponenten, Module, Navigation, Xrefs und Ressourcenfamilien.
• Quellen und Steuerung: Repository-Strategien, Versionierung, Playbooks und Docs-as-Code-Governance.
• Darstellung und Zugang: UI-Entwicklung, Branding und Lunr-Suche.
• Entwicklung und Automatisierung: Asciidoctor-Erweiterungen, Antora-Erweiterungen, CI/CD und Container.
• Betrieb und Schutz: Performance, Troubleshooting, private Repositories, Compliance, Wartung und Upgrades.
• Transformation und Publishing: Migration und Multi-Format-Ausgabe mit Assembler.

Empfohlene Besuchsreihenfolge

Für einen vollständigen Aufbaupfad empfiehlt sich die folgende Reihenfolge. Bereits vorhandene Kompetenzen können durch einen gezielten Einstieg in einen späteren Baustein berücksichtigt werden.

1. Antora – Grundlagen, Installation und erste Dokumentationssite
2. Antora – AsciiDoc für technische Dokumentation
3. Antora – Content-Komponenten, Module und Navigation
4. Antora – Xrefs, Ressourcen-IDs und robuste Verlinkung
5. Antora – Content-Repositories, Versionierung und Multi-Repository-Strategien
6. Antora – Playbook, Site-Konfiguration und lokale Builds
7. Antora – UI-Entwicklung und Branding mit dem Default UI
8. Antora – Suche mit Lunr und Informationszugang
9. Antora – CI/CD, Container und automatisierte Veröffentlichung
10. Antora – Betrieb, Performance und Troubleshooting
11. Antora – Sicherheit, private Repositories und Compliance
12. Antora – Upgrade, Wartung und Release-Management

Nach dem Grundlagenpfad folgen je nach Aufgabe die Vertiefungen zu Docs-as-Code-Governance, Asciidoctor-Erweiterungen, Antora-Erweiterungen, Migration oder Multi-Format-Publishing.

Rollenbasierte Lernpfade

• Technische Redaktion und Content-Architektur: Grundlagen, AsciiDoc, Content-Komponenten, Xrefs, Docs-as-Code-Governance und bei Bedarf Migration.
• Plattformbetrieb und DevOps: Architektur, Grundlagen, Playbook, Repositories, CI/CD, Betrieb, Sicherheit und Upgrade-Management.
• Frontend und Informationszugang: Grundlagen, UI-Entwicklung, Branding und Lunr-Suche.
• Entwicklung und Tooling: AsciiDoc-Grundlagen, Asciidoctor-Erweiterungen sowie Erweiterungen und Pipeline-Automatisierung.
• Projekt- und Migrationsleitung: Architektur, Kompaktseminar, Migration, Sicherheit und ein projektbezogener Ausbaupfad.

Kompakt- und Intensivformate

Das dreitägige Kompaktformat eignet sich für Teams, die schnell eine belastbare Pilotumgebung mit Content-Modell, Playbook, UI, Suche, CI-Build und Betriebsübergabe benötigen. Das fünftägige Intensivformat fasst sämtliche Themenfelder in einem durchgängigen Referenzprojekt zusammen. Es vermittelt Gesamtzusammenhang und Arbeitsfähigkeit, ersetzt bei hochspezialisierten Aufgaben jedoch nicht die jeweiligen Entwicklungs-, Migrations- oder Betriebsvertiefungen.

Auswahl nach Projektphase

• Vor der Toolentscheidung: Architektur und Einsatzplanung.
• Für den Pilot: Grundlagen oder das Kompaktseminar.
• Für die Content-Migration: Content-Komponenten, Xrefs und Migration.
• Für die Produktionsreife: Playbook, CI/CD, Betrieb und Sicherheit.
• Für die Benutzeroberfläche: UI-Entwicklung und Suche.
• Für Erweiterungen und Sonderlogik: Asciidoctor-Erweiterungen oder Antora-Erweiterungen.
• Für den langfristigen Lebenszyklus: Upgrade, Wartung und Release-Management.

Dauerlogik der Formate

Die Dauer wurde je Seminar anhand von Lernzielen, notwendiger Übungstiefe, Integrationsumfang und erforderlichen Testschleifen festgelegt. Ein Tag ist auf Entscheidungs- und Architekturarbeit begrenzt. Zwei Tage erlauben eine vollständige Fachpraxis. Drei Tage sind für komplexe Integrations- oder Transformationsstrecken vorgesehen. Vier Tage werden nur für umfangreiche Erweiterungsentwicklung benötigt. Das Intensivformat nutzt die maximale Dauer von fünf Tagen.