tekom - Tagungen

Einstieg in Documentation-as-Code mit AsciiDoc

  • Workshop
  • Erstellungsprozess und -technologien
  • 27. April
  • 09:00 - 10:30 AM (MEZ)
  • Raum 7/8/9
  • beendet
  • Folien
  •  Alexander Schwartz

    Alexander Schwartz

Inhalt

AsciiDoc ist eine leichtgewichtige Markup-Sprache, aus der automatisiert zum Beispiel HTML- oder PDF-Dokumente erstellt werden können.

Dies ist ein Workshop für Einsteiger: Nach einer kurzen Einführung setzen die Teilnehmer gemeinsam in Gruppen kleine Texte in AsciiDoc in einem web-basierten Editor um.

 

Die Teilnehmer bringen ihren eigenen Laptop mit installiertem Web-Browser (vorzugsweise Google Chrome) zum Workshop mit.

 

Das lernen Sie

  • Möglichkeiten von AsciiDoc kennenlernen und gegenüber anderen Markup-Sprachen abgrenzen können.
  • Verständnis der Konzepte und Einsatzmöglichkeiten.
  • Hilfsmittel kennenlernen, um selber Inhalte erstellen zu können.

Vorkenntnisse

Erste Erfahrungen mit einer anderen Markup-Sprache wie Markdown sind hilfreich, jedoch keine Voraussetzung für den Workshop.

Die AsciiDoc-Dokumentation liegt in englischer Sprache vor, daher sind Kenntnisse der englischen Sprache notwendig.

Erfahrungen im Erstellen von technischer Dokumentation helfen den Teilnehmern die passenden Beispiele in der Gruppenarbeit zu finden.

 

Referent:in

 Alexander Schwartz

Alexander Schwartz

Biografie

Beruflich und privat entwickelt er OpenSource-Software, zusätzlich bringt er die Erfahrung als Software-Architekt und IT-Berater mit.

Er engagiert sich in der AsciiDoc Working Group der Eclipse Foundation und ist Maintainer des AsciiDoc Plugins für IntelliJ. Auf Konferenzen und bei User Groups spricht er über Documentation-As-Code, JavaScript-Frontends, Java-Backends und Kubernetes.