Wie gelingt ausgezeichnete Softwaredokumentation?

Nichts ist in der Softwareentwicklung nachhaltiger als eine saubere Dokumentation – schließlich habt Ihr ja auch stets von gut dokumentierten Bibliotheken profitiert.

Zum Glück gibt es heute effizientere Umgebungen als Word oder Confluence dafür. Mit einer vereinfachten Auszeichnungssprache (Habt Ihr das Wortspiel im Titel erkannt?) lassen sich Dokumente in einer IDE oder jedem beliebigen Texteditor erstellen und bearbeiten. Dabei bleiben alle Inhalte und Konfigurationen einfach lesbar und editierbar, ganz im Gegensatz zu eigenwilligen WYSIWYG-Programme oder Wiki-Plattformen. Wenn die Dokumentation als «Code» zur Verfügung steht, dann kann sie auch wie normaler Quellcode mit allen modernen DevOps-Werkzeugen verarbeitet werden.

Ausgezeichnete Softwaredokumentation gelingt durch einen ganzheitlichen Ansatz aus
  1. einer vereinfachten Auszeichnungssprache,
  2. einem Dokumentationsgenerator und
  3. einfach umsetzbaren (wahrscheinlich überraschenden) organisatorischen Maßnahmen
Und das ist genau das, was Ihr in diesem Talk hören und sehen werdet.

Vergesst alle Vorurteile und schlechte Erfahrungen, die Ihr über Softwaredokumentation kennt. Ab heute könnt Ihr es besser machen!

Speaker

 

Christian Heitzmann
Christian Heitzmann ist Java-, Python- und Spring-zertifizierter Softwareentwickler mit einem CAS in Machine Learning. Als Inhaber der SimplexaCode AG dokumentiert er Softwarearchitekturen für KMUs und unterstützt ihre Softwareeabteilungen mit Schulungen in modernen Entwicklungstechnologien. Er schreibt regelmäßig Artikel für IT-Fachzeitschriften.

betterCode-Newsletter

Du möchtest über die betterCode() ArchDoc und weitere unserer betterCode()-Events auf dem Laufenden gehalten werden?

 

Anmelden