Stop Writing Documents – Start Writing Code (Meetup zum Tool Antora)

ACHTUNG: Terminverschiebung aufgrund von Krankheit. Neuer Termin 08.12.2022!

Wir laden herzlich ein zu einem Online-Meetup von Tech Talks @msg:
---------------------------------------------------------------------------------------------------
WANN? ///
Donnerstag, 08.12.2022, 18:00 - ca. 19:30 Uhr
WO? ///
Online via Microsoft Teams (Zum Meetingraum!)
THEMA? ///
Stop Writing Documents – Start Writing Code (Meetup zum Tool Antora)
---------------------------------------------------------------------------------------------------
DARUM GEHT'S ///
---------------------------------------------------------------------------------------------------
Dokumentation von Code ist zumindest für die Vermarktung fast noch wichtiger als der Code selbst. Trotzdem ist es meist eine ungeliebte Aufgabe für Entwickler. Zum Glück gibt es AsciiDoc, eine Sprachnotation, um Texte codenah zu schreiben und in einem VCS wie z.B. Git abzulegen.

Aus jeder AsciiDoc-Datei wird per Asciidoctor und ggf. Asciidoctor Extensions jeweils ein Dokument in verschiedenen Formaten erzeugt. Wie wäre es, wenn es ein Tool gäbe, das nicht nur einzelne Dokumente, sondern eine in sich verlinkte Gesamtdokumentation generiert? Auch wenn die AsciiDoc-Dateien verteilt sind auf verschiedene Repositories?
In diesem Vortrag wird vorgestellt, wie Antora genutzt werden kann, um eine Gesamtdokumentation aus verschiedenen Repositories zu erzeugen. Es wird erläutert, wie Antora Versionierung der Dokumentation unterstützt und welche Erweiterungsmöglichkeiten es für Antora gibt. Alle Punkte werden sowohl im konzeptuellen Überblick als auch mit kurzen Praxisbeispielen gezeigt.

AsciiDoc wird nicht gesondert vorgestellt. Vorkenntnisse sind hilfreich, aber nicht zwingend notwendig.
---------------------------------------------------------------------------------------------------
AGENDA ///
----------------------------------------------------------------------------------------------------
18:00: Tech Talk von Liane Lenke
Im Anschluss: Fragen & offener Austausch
---------------------------------------------------------------------------------------------------
SPEAKERIN ///
----------------------------------------------------------------------------------------------------
Liane Lenke hat als Diplom-Informatikerin im Lauf von über 20 Jahren Erfahrungen im gesamten Bereich der Software-Entwicklung gewonnen. Seit 2015 ist sie bei msg systems ag angestellt, dem Kern der Unternehmensgruppe msg. msg ist ein Beratungs- und IT-Unternehmen, das seine Kunden bei der digitalen Transformation unterstützt.
Neben weiteren Architekturthemen im Bereich Weiterentwicklung von Software-Factories befasst sie sich seit mehr als einem Jahr mit dem Thema Dokumentation mit Antora und hat das Tool beim Kunden eingeführt.
---------------------------------------------------------------------------------------------------
WIR FREUEN UNS AUF EUCH ///
----------------------------------------------------------------------------------------------------