Kostenloser Tech-Talk - Docs as Code

In diesem Tech-Talk möchte ich am Beispiel von Asciidoctor zeigen, wie eine Alternative zu klassischen Dokumentationswerkzeugen aussehen kann, wie diese funktioniert, und wie sich Dokumentation als Code in den Softwareentwicklungsprozess einbinden lässt. Gerade für agile Projekte kann die kontinuierliche Fortschreibung und Verbesserung der Dokumentation damit sehr effektiv und effizient gestaltet werden. Die Möglichkeiten für die Einbindung von Grafiken / Diagrammen, Quellcode und die Tool-Unterstützung stehen ebenfalls im Fokus.

Zielgruppe:

für alle technisch Interessierten

Voraussetzung:

Interesse an technischen IT Themen

Ziele/Nutzen des Seminars:

in ihre Arbeit, stellen sich den Fragen des Publikums und diskutieren zu ausgewählten Schwerpunktthemen. Es ist zusätzlich möglich, persönliche Gespräche zu Jobchancen mit den Verantwortlichen zu führen. Die Teilnahme am Event ist kostenlos.

Inhalte:

• AsciiDoc, Asciidoctor, AsciidoctorJ
• Eine Beispiel-dokumentation
• Syntax von AsciiDoc
• Diagramme
• Maven-Plugin
• Output PDF, HTML
• Quellcode in AsciiDoc einbinden
• Code in Textfluss einfügen
• Code als Block einfügen
• Code per Include-Anweisung referenzieren
• Code-Auszüge mit Tags referenzieren
• Eclipse Asciidoctor Editor