für verständliche Anleitungen
… verständlich schreiben.
Strukturen, Konzepte, praktische Tipps.
Das Buch „Software-Anleitungen“ ist fertig und bestellbar (bei mir im Shop sofort lieferbar).
Das Buch ist auch im Buchhandel erhältlich (ISBN 9783752815528).
Meine Workshopteilnehmer erhalten das Buch kostenlos.
Auch der Vorabkauf und die Anrechnung im Workshop sind möglich.
Immer mehr Technik ist Software oder software-gesteuert. Dabei wird die Leistung immer umfangreicher und die Bedienung häufig immer leichter. Herkömmliche Anleitungskonzepte stoßen an ihre Grenzen, vor allem wirkt die beliebte Schritt-für-Schritt-Anleitung langatmig und unterfordernd.
In dieser Kategorie stelle ich Konzepte vor, wie Handlungen oder Funktionen flexibel strukturiert werden können. Grundlage ist immer noch die Juhl’sche Handlungsanweisung, die sich für Software aber ganz anders und stark erweitert darstellt. Sie läßt sich sowohl für handlungsorientierte als auch funktionsorientierte Anleitungen heranziehen und kann durch Weglassen, Betonen oder „nur erwähnen“ an den jeweiligen Bedarf angepasst werden.
Hier im Blog stelle ich meine Überlegungen zur Diskussion und hoffe auf fachlichen Austausch zu diesem wichtigen Thema.
In einem eintägigen Workshop haben Sie Gelegenheit, die angebotenen Konzepte im Team weiter zu entwickeln und auf Ihre eigenen Fälle anzuwenden. Dieser arbeitsintensive Workshop richtet sich an TRs, die bereits Software-Anleitungen geschrieben haben.
Nebenbei entsteht ein neues Buch zu Software-Anleitungen, mit Konzepten und Beispielen ähnlich meinem ersten Buch (Technische Dokumentation, praktische Anleitungen und Beispiele, 3. Auflage 2015, Springer-Verlag).
Anleitungen für Software sind anders, weil häufig sehr viele Features vermittelt werden müssen und „viel Anleitung“ durch intuitive Bedienkonzepte überflüssig wird. Um dem gerecht zu werden, müssen mit neuen Überlegungen und Konzepten, Strukturen gefunden werden, die sich flexibel an die Eigenart der Software und der Funktionen anpassen lassen. Das vom Autor entwickelte Modell bietet mehr als 10 systematische Beschreibungsansätze, die richtig kombiniert zur Handlung anleiten oder mit Funktionswissen Kompetenz beim Anwender aufbauen.
„Software-Anleitungen verständlich schreiben – Konzepte, Strukturen, Beispiele“ wendet sich an alle Technischen Redakteure, die ihren Schreibstil mit systematischen Überlegungen unterfüllen wollen, um leichter und schneller zu guten Software-Anleitungen zu kommen.
In diesem arbeitsintensiven Workshop erlernen und üben Sie neue Beschreibungsmodelle an Ihren eigenen Beispielen. So können Sie die systematischen Modelle sofort erproben und durch unmittelbares Feedback optimieren.
Das zielorientierte Schreiben, wie es Dietrich Juhl in seinem Buch entwickelt, hat sich als der Schlüssel für strukturiertes, verständliches Schreiben von Anleitungen bewährt.
Speziell für Software-Anleitungen hat der Autor neue Strukturen entwickelt, die sich flexibel an den sehr unterschiedlichen Bedarf moderner Software anpassen lassen:
Anleitungen für Software sollen den Anwender in die Lage versetzen, sich selbstständig einzuarbeiten und bei Bedarf schnell die notwendigen Informationen zu finden.
Die folgende Darstellung soll einen Überblick über die wesentlichen Prozessschritte geben.
Software-Anleitungen können handlungsorientiert oder funktionsorientiert geschrieben werden. Eine Auszeichnung mit XML ist optional. Wichtig ist vor allem die Verständlichkeit. Wie kann die Software-Anleitung gegliedert werden? Wie lassen sich Handlungsanweisungen strukturiert schreiben? Sind Schritt-für-Schritt-Anleitungen sinnvoll?
Um in Software zum Handeln anzuleiten wurde die altbewährte Handlungsanweisung um viele Punkte erweitert.
Diese Struktur ist Grundlage für alle Handlungsanweisungen bei SW und kann individuell durch Weglassen und Betonen einzelner Punkte flexibel für sehr unterschiedliche Funktionen und Handlungen eingesetzt werden. (Das obige Bild gibt es als Postkarte, zu bestellen bei juhl.de/buecher.)
Die erweiterte Handlungsanweisung für Software sieht folgendermaßen aus:
Je nach Anforderung können die einzelnen Elemente skaliert werden
(was ich im Bild durch den Equalizer andeuten will), z.B.:
Bei hardwaregeprägten Geräten hat sich mittlerweile die handlungsorientierte Anleitung durchgesetzt:
Bei Software ist die Situation häufig anders:
Aus meiner Sicht gibt es zwei Ansätze Softwareanwender zu befähigen:
Meine momentanen Strukturentwürfe stelle ich hier vor:
Aus meiner Sicht muss man als TR alle Strukturelemente beherrschen
und kann sie flexibel je nach Bedarf zu einer Handlungsanweisung oder Funktionsbeschreibung zusammen setzen.
Wie Sie sehen sind beide Strukturen sehr ähnlich.
Was meinen Sie dazu?
Früher haben wir Anleitungen geschrieben, bei denen der Inhalt für das (lineare) Buch gegliedert war:
Diese Reihenfolge soll es dem Anwender ermöglichen seinen aktuellen Informationsbedarf zu decken, der inter- und intra-individuell durchaus unterschiedlich sein kann:
Heute nennen wir das gerne Use Cases. Die Anleitung muss geeignet sein, Antworten bei allen Use Cases zu geben (gemeint sind die Use Cases der Anleitung).