Am 25. November 2025 fand die vierte SL InfoHour statt, bei der sich über 170 Teilnehmerinnen und Teilnehmer mit dem Thema „Software-Anleitungen leicht gemacht“ beschäftigten. Im Mittelpunkt der Veranstaltung stand die Frage, wie technische Redakteurinnen und Redakteure Software-Dokumentationen so gestalten können, dass sie Anwendern den Einstieg erleichtern, Verständnis schaffen und gezielt zum selbstständigen Handeln anleiten.
Wir, die SL innovativ GmbH, sind ein erfahrener Full-Service Dienstleister im Bereich der Technischen Dokumentation und seit über 25 Jahren am Markt aktiv. Mit fünf Standorten in Deutschland und einem Team von 75 Mitarbeitern bedienen wir täglich eine breite Palette von Kunden aus über 15 Branchen. Unser Team besteht aus Fachleuten mit tiefem Wissen in der Maschinensicherheit und Technischen Dokumentation, was uns eine besondere Vertrauensstellung bei unseren Kunden einbringt.
Wir bieten eine Reihe von Dienstleistungen an, die alle Aspekte der Technischen Dokumentation abdecken. Von der Erstellung von Betriebsanleitungen über Technische Illustrationen bis hin zu umfassenden Dokumentationen für komplexe Maschinen reicht unser Portfolio. Ein besonderes Highlight ist unser Docu-Check – ein Service, bei dem Kunden ihre Technischen Dokumentationen auf Aktualität, rechtliche Konformität und normgerechte Inhalte überprüfen können. Dabei erhalten sie ein detailliertes Dossier mit Verbesserungsvorschlägen und Handlungsempfehlungen.
Software-Anleitungen sind ein zentraler Bestandteil moderner technischer Dokumentation. Sie helfen Anwenderinnen und Anwendern, Software nicht nur zu bedienen, sondern auch zu verstehen – und damit sicher, effizient und selbstständig zu arbeiten. In der SL InfoHour beleuchtete Dietrich Juhl die Grundlagen, Methoden und Herausforderungen beim Erstellen verständlicher Software-Anleitungen und zeigte praxisnah, wie komplexe Funktionen in nachvollziehbare Handlungsanweisungen übersetzt werden können.
Dietrich Juhl ist Technischer Redakteur, Trainer, Berater und Fachbuch mit langjähriger Erfahrung in der Software-Dokumentation. Er vermittelt, wie technische Kommunikation Nutzerinnen und Nutzer gezielt zum Verstehen und Handeln befähigt.
Wer tiefer in das Thema einsteigen möchte, findet in seinen Büchern – insbesondere in „Software-Anleitungen verständlich schreiben“ – eine ausführliche Beschreibung der Prinzipien, Beispiele und Methoden, die auch in der InfoHour vorgestellt wurden.
Während wir bei physischen Geräten sofort an Griffe, Knöpfe und Funktionen denken, bleibt Software zunächst abstrakt.
Gute Anleitungen schaffen hier Orientierung: Sie übersetzen komplexe Abläufe in verständliche Konzepte, die Anwendern den Zugang erleichtern.
Eine gute Software-Anleitung verfolgt zwei Ziele:
Diese Kombination aus Erklären und Anleiten ist der Schlüssel zu echter Nutzerkompetenz.
Dietrich Juhl zeigte eine Gliederung, die den gesamten Lernprozess abbildet:
Diese Struktur schafft eine Brücke zwischen Lernen, Festigen und Nachschlagen.
Der Einstieg erfolgt mit der Leistungsbeschreibung – sie hilft dem Leser, die Software einzuordnen und ihr Potenzial zu erkennen.
Darauf folgt der Überblick, in dem die zentralen Software-Konzepte erklärt werden, z. B.:
Damit beantwortet der Überblick die Fragen:
„Was macht die Software?“
„Wie tickt sie?“
„Was kann ich einstellen?“
Im nächsten Schritt werden Handlungsmöglichkeiten vorgestellt – mit klarer Reihenfolge und Bildunterstützung.
Das Prinzip: Storytelling.
Anleitungen erzählen, was geht, und veranschaulichen dies mit Symbolen oder Screenshots.
Beispiel:
„Sie können ein neues Dokument anlegen.“
„Sie können die Papiergröße festlegen.“
„Sie können das Dokument speichern oder drucken.“
So entsteht ein roter Faden, der sich leicht nachvollziehen lässt.
Screenshots und Beschriftungen sind hilfreich, aber allein oft wenig aussagekräftig.
Besser ist es, die Oberfläche im Handlungskontext zu erklären – also dort, wo der Nutzer sie wirklich braucht.
Eine tabellarische Darstellung mit nummerierten Elementen schafft Überblick, ohne zu überfordern.
Hier lernt der Nutzer das Grundprinzip der Software kennen.
Am Beispiel von MS Word:
Jede Tätigkeit ist eine Handlungsanweisung – kurz, nachvollziehbar und mit einem klaren Ziel.
Wenn die Grundlagen sitzen, geht es darum, Routine zu schaffen.
In der Phase der Normalbedienung helfen praxisnahe Formate:
So bleibt die Dokumentation lebendig und anwenderorientiert.
Tätigkeiten sind das Herzstück der Anleitung:
Hier wird erklärt, wie man in der Software handelt.
Jede Handlung steht als eigener Topic – logisch gegliedert, von häufig bis selten, und immer mit einem klaren Ziel.
Jede Handlungsanweisung folgt einer festen Struktur:
Beispiel:
„Sie können festlegen, dass zu regelmäßigen Terminen ein Protokoll gespeichert und automatisch als E-Mail versandt wird.“
„Das ist z. B. praktisch, um den Systemzustand lückenlos zu dokumentieren.“
Diese Art von Formulierung verbindet Handlung mit Nutzen.
Für komplexe Software-Funktionen braucht es zusätzliche Elemente wie:
Ein Beispiel zeigt, wie Parameter selbst als Handlungsaufforderung dienen können, z. B.:
„Aktivieren Sie den Binäreingang, wenn Sie ihn benutzen wollen.“
So bleibt die Dokumentation auch bei technischen Systemen konkret und anwendungsnah.
Im letzten Abschnitt werden die einzelnen Funktionen beschrieben – etwa die Menübefehle einer Software.
Für jede Funktion gilt:
Beispiel:
Zweck: „Dateigröße verringern“
Funktion: „Bilder komprimieren“
Ergebnis: „Die Auflösung wird angepasst, die Datei verkleinert gespeichert.“
Eine gute Funktionsbeschreibung zeigt also Nutzen statt nur Referenz.
Zum Abschluss brachte Dietrich Juhl die Kernaussagen auf den Punkt:
So wird aus einer Dokumentation kein bloßes Nachschlagewerk, sondern ein echter Lernbegleiter – einer, der Nutzer vom Verstehen ins Handeln führt.
Sie möchten mehr über das Thema erfahren?
Kontaktieren Sie uns gerne – wir senden Ihnen die Unterlagen zu und beraten Sie individuell zu Ihren Fragen!
Gemeinsam mit Ihnen analysieren wir Ihre bestehende Software-Dokumentation und zeigen, wie Sie Verständlichkeit, Effizienz und Nutzererlebnis gezielt verbessern können. In Kooperation mit Dietrich Juhl bieten wir Ihnen eine fundierte Dokumentationsprüfung mit klarer Handlungsempfehlung – praxisnah, verständlich und direkt umsetzbar.
Lucas Schott
Gruppenleiter Technische Dokumentation,
AR & VR Experte
Telefon: +49 (0)9851-58 258 23
Mail: l.schott@sl-i.de