Einfache Softwarearchitektur-Dokumentation: Know-how auf der Heise-Konferenz

Der Entwurf ist gelungen und nun folgt – oh weh! – das lästige Drumrum: Insbesondere die Dokumentation – Berichte, Listen, Diagramme. Viele Softwarearchitektinnen und -entwickler empfinden das als lästig. Dabei geht es oft einfach und aufs Ganze gesehen leichtgängig. Die von iX und dpunkt.verlag für den 30. September 2024 angekündigte Online-Konferenz betterCode() ArchDoc vermittelt hier das nötige Wissen für moderne Dokumentationskonzepte und hilfreiche Tools, die geschickte Wege durch den Doku-Dschungel schlagen.

Die betterCode() ArchDoc richtet sich an Profis aus den Bereichen Softwarearchitektur, Softwareentwicklung und IT-Projektleitung. Sie lernen, Architektur effektiv und effizient zu dokumentieren und Änderungen während des Projektverlaufs strukturiert im Blick zu behalten. Die Referentinnen und Referenten zeigen moderne Ansätze wie Docs-as-Code, Architecture Communication Canvas oder Domain-driven Dokumentationsdesign. Und natürlich gibt es Tipps von Profis, Best Practices und Erfahrungsberichte aus dem Alltag. Nach jedem Vortrag findet eine kleine Diskussion statt, in der die Teilnehmerinnen und Teilnehmer Fragen stellen.

Die Themen im Programm sind:

• Gernot Starke, Maximal sparsam – Der Architecture Communication Canvas: die wesentlichen Highlights eines Systems in superkompakter Form und dennoch strukturiert darstellen.
• Charlotte Scharbert, C4 – Documentation to blow (up) your mind!: eine frische Perspektive auf die Dokumentation mit verständlichen und zielgruppengerechten Diagrammen.
• Michael Plöd, Bessere Architekturdokumentation mit Hilfsmitteln aus dem Domain-driven Design: kollaborative Modellierungsansätze nicht nur für den Entwurf, sondern auch für die Dokumentation.
• Jana Aydinbas, Softwaredokumentation erstellen – ein Einblick: So entsteht eine Softwaredokumentation aus dem Blickwinkel der Technischen Redaktion.
• Christian Heitzmann, Ausgezeichnete Softwaredokumentation: Dokumentation als Code mit einer einfachen Auszeichnungssprache.
• Alexander Schwartz, Online-Dokumentation, die hilft – Strukturen, Prozesse, Tools: zielgruppengerechte Dokumentationssichten mit AsciiDoc, Antora und weiteren Werkzeugen.

Zwei Workshops mit Praxis

Wer das theoretische Wissen vertiefen möchte, findet Gelegenheit in den ganztägigen Workshops. Stefan Zörner gibt am 8. Oktober 2024 eine Einführung, wie man das Quasistandard-Framework arc42 meistert. Der Referent verspricht im Workshop: "erarbeitet Ihr Euch Antworten auf die häufigsten und praxisrelevantesten Fragestellungen rund um arc42". In der inspirierenden Atmosphäre gibt es auch viel Raum für Fragen und Diskussion.

Am 23. September 2024 hält Matthias Eschhold einen Workshop zum Thema Flexible Anwendungsarchitektur mit der Clean und der Hexagonal Architecture. Er übt fortschrittliche Architekturmuster ein, was von allgemeinem Interesse für Softwarearchitektinnen und -architekten ist.

Jetzt Frühbucherrabatt sichern

Bis zum 8. September 2024 kostet ein Ticket 229 Euro (alle Preise zuzüglich 19 Prozent Mehrwertsteuer), später dann 279 Euro. Ein Mengenrabatt für Team-Buchungen wird im Ticketshop automatisch eingepreist. Auch Schülerinnen, Schüler, Studierende und Hochschulangehörige erhalten auf Anfrage Rabatt.

Die zusätzlichen Online-Workshops am 23. September und 8. Oktober kosten je 549 Euro. Wer über den Fortgang der Konferenz auf dem Laufenden bleiben möchte, kann sich auf der Konferenz-Webseite informieren und dort zum Newsletter anmelden. Der Social-Media-Hashtag lautet #bcc_archdoc.

(who)