Martina Hartmann - Informationsentwicklerin – Impulse

Kurz durchdacht | Überschriften

Thu, 18 Jun 2026 00:00:00 +0000

Eine Überschrift ist kein Platzhalter. Sie ist eine Aussage.

“Einleitung”, “Allgemeines”, “Hinweise” — wer so überschreibt, hat die Struktur beschriftet, nicht den Inhalt. Das ist der Unterschied zwischen einem Schrank mit dem Etikett “Schrank” und einem mit dem Etikett “Winterjacken”. Beides stimmt. Nur eines hilft.

Lesende entscheiden in Sekunden, ob ein Abschnitt für sie relevant ist. Eine Überschrift ohne Aussage nimmt ihnen diese Entscheidung nicht ab — sie zwingt sie, trotzdem reinzulesen. Das kostet Zeit. Und es ist vermeidbar.

So sieht das aus:

❌ “Allgemeines”
❌ “Weitere Informationen”
❌ “Hinweise zur Verwendung”

Was stattdessen möglich ist:

✅ “Systemvoraussetzungen auf einen Blick”
✅ “Was Du vor der Installation wissen musst”
✅ “Diese Funktion ist nur für Admins”

Gleicher Inhalt. Aber Lesende wissen vorher, was sie erwartet — und können selbst entscheiden, ob es für sie relevant ist.

Eine Überschrift, die nicht aussagt, was folgt, ist keine Überschrift. Sie ist Dekoration.

Perspektivwechsel | Weglassen ist eine Entscheidung

Mon, 15 Jun 2026 00:00:00 +0000

Vollständigkeit ist das beliebteste Qualitätsmerkmal in der Kommunikation. Und das folgenreichste.

🔎 In der Praxis

Eine neue Software. Ein neues Verfahren. Ein neues Produkt. Es gibt ein Dokument dazu — vollständig, alles drin. Du öffnest es mit einer konkreten Frage. Du schließt es, ohne sie beantwortet zu haben. Nicht weil die Antwort fehlt. Sondern weil sie irgendwo zwischen Überblick, Einleitung, Hinweisen und Ausnahmen verschwunden ist.

💡 Die Logik dahinter

Der Reflex bei Komplexität ist immer derselbe: mehr erklären, besser absichern, nichts auslassen. Vollständigkeit gilt als Qualitätsmerkmal. Wer alles reinschreibt, kann nichts falsch gemacht haben. Das stimmt — für die Schreibenden. Für alle anderen bedeutet Vollständigkeit: selbst suchen, selbst filtern, selbst entscheiden, was relevant ist.

⚠️ Der blinde Fleck

Information Overload wird als Empfangsproblem behandelt. Zu viel auf einmal, zu kurze Aufmerksamkeitsspanne. Das verlagert das Problem auf die Lesenden. Die eigentliche Ursache liegt früher: bei der Entscheidung, was nicht rein muss. Diese Entscheidung ist unbequem. Sie erfordert Urteil. Also wird sie nicht getroffen.

🔄 Der Perspektivwechsel

Weglassen ist keine Vereinfachung. Es ist eine redaktionelle Entscheidung — und die schwierigste im Prozess. Wer entscheidet, was fehlen darf, übernimmt Verantwortung dafür, was bleibt. Das ist mehr Arbeit als Vollständigkeit. Und es ist die einzige, die beim Lesen wirklich ankommt.

Kurz durchdacht | Satzlänge

Thu, 11 Jun 2026 00:00:00 +0000

Lange Sätze klingen nach Arbeit. Sie sind es auch — meistens unnötige.

Auf Deutsch gilt Satzkomplexität als Qualitätsmerkmal. Wer aneinanderreiht, Einschübe setzt, Bedingungen nachliefert, signalisiert: Ich habe gründlich gedacht. Was dabei entsteht, muss jemand anderes wieder entwirren.

Das sieht so aus:

❌ “Das System führt, nachdem Du die Konfiguration abgeschlossen und alle Pflichtfelder ausgefüllt hast, einen automatischen Neustart durch.”
❌ “Bitte beachte, dass diese Funktion nur dann verfügbar ist, wenn Du Dich im Admin-Modus befindest.”
❌ “Der Prozess, der für die Synchronisierung zuständig ist, wird gestartet, sobald Du die Schaltfläche drückst.”

Aufgeteilt:

✅ “Konfiguration abgeschlossen? Pflichtfelder ausgefüllt? Das System startet neu.”
✅ “Diese Funktion ist nur im Admin-Modus verfügbar.”
✅ “Drück die Schaltfläche. Der Synchronisierungsprozess startet.”

Kurze Sätze sind weniger Arbeit — beim Schreiben und beim Lesen. Niemand verliert dabei etwas. Außer der Illusion, dass Komplexität Kompetenz beweist.

Perspektivwechsel | Fachsprache als Zugangssystem

Mon, 08 Jun 2026 00:00:00 +0000

Fachsprache hat eine Funktion, über die selten gesprochen wird.

🔎 In der Praxis

Im Arztgespräch fällt ein Begriff, den Du nicht kennst. Du fragst nach. Die Reaktion vermittelt Dir Ungeduld. Im Rechtsdokument stehen Konstruktionen, die Du dreimal liest, ohne sicher zu sein. Im Meeting nicken alle, wenn jemand Abkürzungen verwendet, die Du nicht kennst. Du lernst: Fragen kostet etwas.

💡 Die Logik dahinter

Fachsprache ist nicht automatisch Präzisionswerkzeug. Sie ist auch Zugangssystem. Wer die Sprache beherrscht, signalisiert Zugehörigkeit und darf mitreden. Wer sie nicht beherrscht, stellt Fragen — oder schweigt. Beides wird registriert. Das funktioniert in Arztpraxen, Gerichten, Wissenschaft und Unternehmen gleichermaßen.

⚠️ Der blinde Fleck

Ob ein Begriff wirklich notwendig ist oder nur vertraut, wird selten gefragt. Vertrautheit mit Sprache wird als Kompetenz gelesen — von denen, die sie teilen, und oft auch von denen, die sie nicht verstehen. Wer Jargon verwendet, wirkt wie jemand, der weiß, wovon er redet. Das ist kein Versehen. Es ist der Vorteil.

🔄 Der Perspektivwechsel

Verständlich zu schreiben oder zu sprechen ist kein Stilmerkmal. Es ist ein Verzicht — auf Abgrenzung, auf Zugehörigkeitssignale, auf den Schutz, den Insider-Sprache bietet. Das erklärt, warum verständliche Sprache so selten wirklich gewollt wird. Auch dort, wo alle behaupten, sie anzustreben.

Kurz durchdacht | Sprache schafft Wirklichkeit

Thu, 04 Jun 2026 00:00:00 +0000

Die Terminologie existierte, bevor wir Cis-Menschen sie kannten. Pride Month ist ein Kanal, über den sie alle erreichen kann.

Bevor Begriffe wie non-binary, cis oder queer – als Eigenbezeichnung – etabliert waren, fehlte nicht nur das Wort. Es fehlte der anerkannte Referenzpunkt.

Ohne Terminus kein Konzept. Ohne Konzept keine Diskussion. Ohne Diskussion keine Veränderung.

Pride-Terminologie ist kein Aktivismus-Vokabular. Es ist ein Beispiel dafür, wie Community-Konsens funktioniert – und warum gute Terminologiearbeit nie nur aus einer einzigen Quelle kommen kann.

Aus der Außenperspektive benannt:

❌ “Transsexualismus” – Pathologisierung als Ausgangspunkt
❌ “biologisches Geschlecht” – suggeriert, alles andere sei konstruiert
❌ “Störung der Geschlechtsidentität” – Diagnose statt Beschreibung

Aus der Community selbst entwickelt:

✅ “non-binary” – schließt eine Lücke, die andere Sprachen längst kennen
✅ “queer” – von Schimpfwort zur selbstbestimmten Eigenbezeichnung
✅ “cis” – gibt der Mehrheit einen Namen, damit “trans” aufhört, die Ausnahme zu sein

Terminologie, die von außen übergestülpt wird, beschreibt nicht – sie wertet.

Die präziseste Terminologie entsteht immer dort, wo die Betroffenen selbst das Wort ergreifen.

Mittagspause | Geteilte Unschärfe fühlt sich wie Konsens an

Mon, 01 Jun 2026 00:00:00 +0000

„Was bedeutet das eigentlich genau?“ Im Meeting wird es still. Dann: „Na ja – du weißt schon, was wir damit meinen.“

Alle nicken. Das Gespräch geht weiter.

Der Begriff steht im Code, in der Dokumentation, in der Produktpräsentation. Seit Jahren. Alle kennen ihn. Alle sind sicher, dass alle dasselbe meinen.

Bis jemand ihn definieren muss. Und in die Runde fragt: Was genau meinen wir damit?

Es wird still. Dann reden alle gleichzeitig.

Das ist keine Kommunikationslücke. Das ist terminologische Illusion.

Geteilte Unschärfe fühlt sich wie Konsens an.

Ein Begriff, den alle kennen und niemand erklären kann, ist kein Fachbegriff. Er ist ein Platzhalter.

Klartext | Struktur entsteht vor dem Schreiben

Thu, 28 May 2026 00:00:00 +0000

Struktur entsteht nicht beim Schreiben. Sie entsteht davor — wenn man sich fragt, was die andere Person eigentlich braucht, um sich zu orientieren.

Wer das überspringt, lässt Lesende alleine. Wer es nicht tut, führt sie.

Klartext | Über ungeklärte Definitionen

Mon, 25 May 2026 00:00:00 +0000

„Bald.“ Jeder weiß, was das bedeutet. Bis zwei Menschen herausfinden, dass sie es völlig anders definieren.

Wenn das bei “bald” passiert, ist es unangenehm. Bei “Eigenverantwortung” wird es kompliziert. Bei “zumutbar” wird es zum Konflikt.

Hinter jedem Wort steckt eine Definition, die niemand ausspricht — und die für jeden ein bisschen anders aussieht. Geformt durch Erfahrungen, Umfelder, Geschichten, die wir nie geteilt haben.

Wir reden ständig miteinander. Aber über unsere Wörter reden wir viel zu selten. Wir setzen voraus, dass das Gleiche gemeint ist — und wundern uns, wenn es kracht.

Das meiste davon wäre vermeidbar. Nicht durch mehr Reden, sondern durch präziseres. Implizite Annahmen aussprechen. Nachfragen, bevor aus Annahmen Probleme werden.

Definitionen sind keine Kleinigkeit. Sie entscheiden, ob wir einander wirklich verstehen — oder nur glauben, es zu tun.

Kurz durchdacht | Aus welcher Perspektive schreibst Du?

Thu, 21 May 2026 00:00:00 +0000

Wer gegen Fehler schreibt, denkt in Fehlern. Wer für Klarheit schreibt, denkt in Lösungen.

Die Perspektive, aus der man an ein Dokument herangeht, prägt das Ergebnis — bevor ein einziges Wort geschrieben ist. Wer gegen Probleme dokumentiert, denkt in Problemen. Wer für Ergebnisse dokumentiert, denkt in Wegen.

Das zeigt sich nicht im einzelnen Satz. Es zeigt sich im Ganzen:

❌ Sicherheitshinweise als Auflistung dessen, was schiefgehen kann.
❌ KI-Richtlinien als Katalog unzulässiger Nutzung.
❌ Onboarding-Dokumentation als Liste von Fallstricken.

Der Ausgangspunkt ist derselbe. Die Frage ist eine andere:

✅ Sicherheitshinweise als Schritte zum sicheren Ergebnis.
✅ KI-Richtlinien als Entscheidungsrahmen für bewussten Einsatz.
✅ Onboarding-Dokumentation als Weg zum ersten Erfolgserlebnis.

Gleicher Inhalt. Andere Grundhaltung. Andere Dokumentation.

Dokumentation, die führt, fragt nicht: Was kann hier falsch laufen? Sie fragt: Wo soll diese Person danach stehen?

Perspektivwechsel | Wer das Symptom behandelt, macht das Problem unsichtbar

Mon, 18 May 2026 00:00:00 +0000

Wer das Symptom behandelt, macht das Problem unsichtbar. Nicht kleiner.

🔎 In der Praxis

Ein neues Tool wird eingeführt. Wie es genutzt werden soll, wer was damit entscheiden darf, was dokumentiert werden muss – offen. Jemand im Team fängt an, Fragen zu sammeln, Antworten auszuprobieren, Ergebnisse zu teilen. Alle sind dankbar. Es läuft.

💡 Die Logik dahinter

Gut gemeintes Einspringen funktioniert. Genau das ist das Problem. Solange jemand das Symptom behandelt, muss niemand das Problem lösen. Die Verantwortung liegt zwar weiterhin dort, wo sie hingehört – sie wirkt nur nicht mehr.

⚠️ Der blinde Fleck

Was wie Unterstützung aussieht, ist Kompensation. Wer einspringt, schützt nicht das Team – sondern die Führung davor, handeln zu müssen. Die Konsequenzen bleiben. Sie kommen nur später, leiser, und dann meistens ohne eindeutige Ursache.

🔄 Der Perspektivwechsel

Das Problem sichtbar zu machen ist unbequemer als das Symptom zu behandeln. Aber es ist verantwortungsvoller. Nicht weil Unterstützung falsch ist – sondern weil manche Entscheidungen an der richtigen Stelle getroffen werden müssen. Wer das Symptom behandelt, übernimmt Verantwortung. Wer das Problem benennt, zeigt, wo sie fehlt.

Perspektivwechsel | Abgehakt ist nicht verstanden

Thu, 14 May 2026 00:00:00 +0000

Abgehakt ist nicht dasselbe wie verstanden. Ob jemand danach handeln kann, hat niemand gefragt.

🔎 In der Praxis

Schulung absolviert. Handbuch gelesen. Einweisung erhalten. In vielen Organisationen gilt damit eine Sache als erledigt – unabhängig davon, was danach passiert. Das Ergebnis sind Menschen, die glauben, vorbereitet zu sein. Und Organisationen, die glauben, sie vorbereitet zu haben. Beides muss nicht stimmen.

💡 Die Logik dahinter

Inhalte, die nicht für die Person gebaut sind, die sie konsumiert, übertragen kein Wissen. Sie übertragen das Gefühl von Wissen. Der Unterschied zeigt sich nicht beim Konsumieren – er zeigt sich im Ernstfall. Dann nämlich, wenn jemand handeln muss und merkt, dass das, was sie gelernt hat, nicht zu der Situation passt, in der sie sich befindet.

⚠️ Der blinde Fleck

Der Haken am Ende einer Schulung misst, ob jemand etwas konsumiert hat. Er misst nicht, ob jemand danach handeln kann. Oft ist das auch nicht seine Aufgabe. Compliance-Rahmenwerke fordern Nachweise – keine Kompetenz. Wer den Haken setzt, erfüllt die Anforderung. Was danach passiert, ist eine andere Frage – und wird erst dann gestellt, wenn etwas schiefgeht.

🔄 Der Perspektivwechsel

Der Maßstab für guten Inhalt ist nicht Vollständigkeit. Und nicht Konsumierbarkeit. Der einzige Maßstab, der zählt: Kann die Person danach das tun, wofür der Inhalt gedacht war? Wenn nicht, war der Haken das Ziel – nicht das Wissen.

Kurz durchdacht | Das Expert:innen-Problem

Mon, 11 May 2026 00:00:00 +0000

Expert:innenwissen ist kein Vorteil beim Erklären. Es ist das Hindernis.

Wer etwas gebaut hat, weiß zu viel. Nicht zu wenig. Die Schritte, die selbstverständlich sind, werden übersprungen. Die Begriffe, die erklärt werden müssten, werden vorausgesetzt. Das Wissen sitzt so tief, dass es unsichtbar wird — auch für die Person, die es hat.

Das zeigt sich in der Praxis:

❌ “Stellen Sie sicher, dass die Abhängigkeiten korrekt konfiguriert sind.” — welche Abhängigkeiten?
❌ “Wählen Sie den passenden Modus.” — passend wofür?
❌ “Das System verhält sich wie erwartet.” — was wird denn erwartet?

Wer die richtigen Fragen stellt, schreibt anders:

✅ “Bevor Sie starten: Diese drei Pakete müssen installiert sein.”
✅ “Modus A für Einzelnutzung, Modus B wenn mehrere Personen gleichzeitig zugreifen.”
✅ “Nach dem Speichern erscheint die grüne Bestätigungsmeldung.”

Gleiches Thema. Anderer Ausgangspunkt.

Die beste Dokumentation schreibt nicht, wer am meisten weiß. Sie schreibt, wer gelernt hat, die richtigen Fragen zu stellen.

Perspektivwechsel | Struktur ist nie neutral

Thu, 07 May 2026 00:00:00 +0000

Deine Struktur sagt den Leuten bereits, was wichtig ist – noch bevor sie das erste Wort gelesen haben.

🔎 In der Praxis

Die Warnung steht nach dem Schritt, der den Fehler auslöst. Die Ausnahme, die auf die Mehrheit zutrifft, steckt eingeklappt unter “Weitere Informationen”. Die Überschrift heißt “Allgemein” — darunter steht die Bedingung, ohne die der Rest nicht gilt. Niemand hat sich dabei etwas gedacht. Genau das ist das Problem.

💡 Die Logik dahinter

Struktur ist nie neutral. Was zuerst steht, bekommt Gewicht. Was eine Überschrift bekommt, wirkt wichtig. Was im Fließtext verschwindet, wird übersehen — unabhängig davon, wie relevant es ist. Jede Strukturentscheidung ist eine Aussage darüber, was zählt. Auch wenn sie niemand bewusst getroffen hat.

⚠️ Der blinde Fleck

Struktur wird oft als Formatierungsfrage behandelt — als letzter Schritt, nachdem der Inhalt steht. Dabei ist sie eine Inhaltsentscheidung. Und noch etwas: Schlechte Struktur fällt selten als Strukturproblem auf. Sie fällt auf als Verwirrung, als Fehler, als Support-Ticket.

🔄 Der Perspektivwechsel

Struktur ist kein Behälter für Inhalte. Sie ist selbst ein Inhalt. Wer das versteht, fängt nicht mit dem Schreiben an — sondern mit der Frage: Was muss zuerst gesehen werden?

Kurz durchdacht | Gewollte Unklarheit

Mon, 04 May 2026 00:00:00 +0000

Vage Sprache ist keine schlechte Gewohnheit. Sie ist Methode.

Niemand schreibt versehentlich so, dass hinterher nichts an einem hängen bleibt. Das braucht Übung.

❌ „Es ist nicht auszuschließen, dass unter bestimmten Umständen Optimierungspotenzial besteht."
❌ „Das Thema befindet sich aktuell in der internen Abstimmung."
❌ „Diesbezüglich werden die nächsten Schritte zeitnah kommuniziert."

Das klingt professionell. Es sagt nichts.

✅ „Das ist ein Problem. Wir lösen es bis Ende des Monats."
✅ „Wir haben noch keine Entscheidung. Das dauert noch bis Ende der Woche."
✅ „Du hörst bis Freitag von uns."

Kein Können-Problem. Ein Wollen-Problem.

Klare Sprache schützt die Lesenden. Vage Sprache schützt die Schreibenden.

Perspektivwechsel | Die einen fürchten KI, die anderen winken ab

Thu, 30 Apr 2026 00:00:00 +0000

Die einen fürchten KI. Die anderen winken ab. Beide haben dasselbe Problem.

🔎 In der Praxis

Die einen fragen, ob ihr Job noch sicher ist. Die anderen winken ab – ihr Handwerk, ihre Expertise sei zu komplex, zu menschlich für eine Maschine. Beide setzen voraus, dass KI an dieselben Grenzen stößt wie wir. Das tut sie nicht. Wer dem Thema ausweicht, verliert dabei etwas Unwiederbringliches: die Zeit, in der man noch selbst entscheiden kann, was dieses Werkzeug für die eigene Arbeit bedeutet.

💡 Die Logik dahinter

KI verändert nicht nur, was möglich ist. Sie verändert, wie man an Dinge herangeht. Ein Werkzeug, das nicht schläft, nicht ungeduldig wird und auf dieselbe Frage aus zehn verschiedenen Blickwinkeln antwortet, je nachdem wie man es anspricht. Das verändert nicht nur, was man produziert, sondern was man überhaupt erst in Angriff nimmt.

⚠️ Der blinde Fleck

“Das kann KI nicht” ist keine stabile Aussage. Ihr Verfallsdatum rückt schneller näher, als man denkt. Das bedeutet nicht, unkritisch zu sein. Es bedeutet, zu verstehen, wie das Werkzeug funktioniert – nicht oberflächlich, sondern tief genug, um einschätzen zu können, was man ihm anvertrauen kann und was nicht.

🔄 Der Perspektivwechsel

Wer noch fünf Jahre oder mehr im Berufsleben vor sich hat, kommt an dieser Auseinandersetzung nicht vorbei. Nicht als Pflicht, sondern weil es Perspektiven eröffnet, die ohne dieses Werkzeug schlicht nicht zugänglich wären. KI ersetzt kein Urteilsvermögen, kein Domänenwissen, keine Erfahrung. Aber sie verändert, was damit möglich ist. Wer das ignoriert, entscheidet sich nicht für Stabilität – sondern dafür, den Anschluss zu verlieren.

Mittagspause | Wir meinen doch dasselbe

Mon, 27 Apr 2026 00:00:00 +0000

„Wir meinen doch dasselbe.“ Zwei Personen im selben Meeting, beide sagen „Nutzer:innen“ – und meinen etwas völlig anderes.

Person A denkt an Menschen, die täglich mit dem System arbeiten – Administrator:innen, die Workflows konfigurieren, Rechte vergeben, Fehler beheben. Person B denkt an Endkund:innen, die einmal im Monat eine Rechnung herunterladen.

Beide haben recht. Beide reden aneinander vorbei. Und weil beide nicken, merkt es niemand. Noch nicht.

Ein Feature geht live, das technisch funktioniert – aber an der eigentlichen Zielgruppe vorbeizielt. Dokumentation hätte die Lücke schließen können. Übersetzen, was das Produkt nicht leistet. Aber auch das setzt voraus, dass jemand weiß, für wen geschrieben wird. Wenn der Begriff nie geklärt wurde, schreibt die Dokumentation für dieselbe Phantomzielgruppe wie das Entwicklungsteam. Nutzende schlagen die richtige Anleitung auf – und kommen nicht weiter, weil sie nie gemeint waren. Tickets häufen sich. Lösungen laufen ins Leere.

Dann heißt es: Kommunikationsproblem.

Aber es war nie ein Kommunikationsproblem. Der Begriff stand im Raum, alle haben ihn benutzt, niemand hat ihn geklärt. Was wie ein menschliches Missverständnis aussieht, ist fast immer ein terminologisches Versäumnis – still, unsichtbar, und mit langer Wirkung.

Wer Begriffe nicht definiert, überlässt die Definition dem Zufall.

Kurz durchdacht | Interne Sprache, externe Doku

Thu, 23 Apr 2026 00:00:00 +0000

„Schreib, wie du sprichst.“ Gemeint als Befreiung. Oft das Gegenteil.

Wer schreibt, wie er spricht, schreibt wie sein Team spricht. Mit dem Slang, den alle kennen – nur die User nicht. Was im Daily klingt wie Präzision, wird in der Doku zur Barriere.

In technischen Teams klingt das so:

❌ “Defaultmäßig ist die Option deaktiviert.”
❌ “Das Feature ist aktuell noch nicht ausgerollt.”
❌ “Einfach mal neu starten.”
❌ “Das triggert dann den nächsten Schritt.”

Der Wechsel ist unspektakulär:

✅ “Die Option ist standardmäßig deaktiviert.”
✅ “Das Feature ist in dieser Version noch nicht verfügbar.”
✅ “Starte die Anwendung neu.”
✅ “Der nächste Schritt startet automatisch.”

Andere Sprache. Gleiche Information.

Dokumentation richtet sich nicht ans Team. Sie richtet sich an alle, die nicht im Raum waren.

Kurz durchdacht | Context Engineering

Mon, 20 Apr 2026 00:00:00 +0000

„Context Engineering“ klingt nach neuem Berufsfeld. Es ist Informationsarchitektur – nur für eine andere Zielgruppe.

Die Erkenntnis dahinter: Ein LLM reagiert nicht auf den einzelnen Prompt, sondern auf alles, was gleichzeitig im Kontext steht. Rollendefinitionen, Dokumente, Beispiele, Einschränkungen. Wer das gezielt gestaltet, bekommt andere Ergebnisse.

Technische Redakteur:innen kennen das seit Jahrzehnten – nur hieß es anders: selektieren, strukturieren, priorisieren, damit die richtige Person zur richtigen Zeit die richtige Information bekommt.

Schlechter Kontext für ein LLM sieht genauso aus wie schlechte Dokumentation für Menschen:

❌ “Schreib etwas über das Produkt.”
❌ “Fass das zusammen.”
❌ “Erkläre das für unsere Nutzer.”

Mit Kontext ändert sich alles:

✅ “Du bist technische Redakteurin. Fass dieses Release-Dokument in 3 Sätzen für Endnutzer:innen zusammen – keine Fachbegriffe, keine Versionsnummern.”
✅ “Schreib eine Fehlermeldung für Fall X. Zielgruppe: nicht-technische Nutzer:innen. Ton: sachlich, lösungsorientiert.”
✅ “Überarbeite diesen Abschnitt nach folgendem Styleguide: […]”

Gleiche Technologie. Anderer Kontext. Anderes Ergebnis.

Context Engineering als neue Disziplin zu feiern setzt voraus, dass man Technische Dokumentation bisher für Schreibarbeit gehalten hat.

Kurz durchdacht | Technische Schulden in der Dokumentation

Thu, 16 Apr 2026 00:00:00 +0000

Technische Schulden in der Dokumentation fallen nicht auf — bis sie jemanden treffen.

Veraltete Inhalte bleiben, weil sie niemand meldet. Lücken wachsen, weil niemand Zeit hat.

Jede nicht aktualisierte Seite macht die nächste wahrscheinlicher. Dokumentationsschulden akkumulieren still — und verzinsen sich.

Das kennen alle, die mit gewachsener Dokumentation arbeiten:

❌ Ein Funktionsname hat sich geändert. In der Doku steht noch der alte.
❌ Ein Prozess wurde vereinfacht. Die Anleitung beschreibt noch fünf Schritte mehr.
❌ Ein Feature wurde entfernt. Die Dokumentation erklärt es noch.

Die Schulden wachsen nicht dort, wo die Entscheidungen getroffen werden. Sie landen bei denen, die die Dokumentation benutzen müssen.

Was den Unterschied macht:

✅ Änderungen an Dokumentation werden aktiv kommuniziert — nicht still deployed.
✅ Veraltete Inhalte werden als Schulden sichtbar gemacht — nicht versteckt.
✅ Dokumentationspflege folgt einem System — nicht dem Zufall.

Schulden verschwinden nicht, wenn man sie ignoriert. Sie werden teurer.

Wer Dokumentation als Produkt versteht, versteht auch: Qualität ist keine Eigenschaft eines ersten Entwurfs. Sie ist das Ergebnis konsequenter Pflege.

Klartext | „Optimiert.“ Was heißt das eigentlich?

Mon, 13 Apr 2026 00:00:00 +0000

„Optimiert.“ Was heißt das eigentlich?

Manche Wörter klingen professionell – und sagen nichts. Wörter, die du garantiert schon mal gelesen (oder selbst geschrieben) hast.

Die gute Nachricht: Du musst nicht auf Klarheit verzichten, um professionell zu klingen. Du musst nur konkret werden.

Verständlichkeit schlägt Buzzwords. Immer.

Perspektivwechsel | Dokumentation ist ein Produkt im Produkt

Wed, 08 Apr 2026 00:00:00 +0000

Dokumentation ist ein Produkt im Produkt. Nur wird sie selten so behandelt.

🔎 In der Praxis

Dokumentation entsteht nach dem Produkt – als Beschreibung von etwas, das bereits existiert. Sie hat einen eigenen Lebenszyklus, eigene Qualitätskriterien, eigene Entscheidungen. Ein technisch einwandfreies System, dessen UI Fragen offen lässt, ist ohne brauchbare Dokumentation für die Menschen, die damit arbeiten müssen, ein schlechtes Produkt.

💡 Die Logik dahinter

Jedes Produkt braucht Menschen, die verstehen, was Nutzer:innen brauchen, was priorisiert werden muss und was kommuniziert werden muss – und was nicht. Diese Entscheidungen treffen nicht die, die das Produkt bauen. Die Entscheidungen treffen die, die es verantworten.

⚠️ Der blinde Fleck

Dokumentation wird als Beschreibung behandelt, nicht als Entscheidung. Dabei steckt in jeder Dokumentation eine Reihe von Entscheidungen: Was ist relevant? Für wen? In welcher Tiefe? In welcher Reihenfolge? Diese Entscheidungen prägen, ob ein Produkt für die Menschen nutzbar ist, die damit arbeiten müssen.

🔄 Der Perspektivwechsel

Dokumentation zu verantworten bedeutet, dieselben strategischen Entscheidungen zu treffen wie für jedes andere Produkt. Wer sind die Nutzer:innen? Was brauchen sie – und was nicht? In welchem Format, in welcher Tiefe, in welchem Umfang? Das sind keine redaktionellen Fragen. Das sind Produktentscheidungen. Dokumentation ist kein Anhang. Sie ist ein Produkt – mit allem, was das bedeutet.

Kurz durchdacht | KI-optimierte Dokumentation

Tue, 31 Mar 2026 00:00:00 +0000

Ein LLM stolpert über dieselben Stellen wie Menschen.

Überall liest man: AI-optimized content, LLM-friendly structure, KI-kompatible Dokumentation. Als hätte KI neue Anforderungen mitgebracht. Hat sie nicht. Sie hat die alten sichtbar gemacht.

Was ein Sprachmodell verwirrt, verwirrt auch Menschen:

❌ Inkonsistente Terminologie: mal “Hinzufügen”, mal “Bestätigen”, mal “Übernehmen” für die gleiche Aktion
❌ Fehlender Kontext: ein Schritt erklärt, was zu tun ist, aber nicht wann oder warum
❌ Ambiguität: “Klicken Sie auf die entsprechende Schaltfläche”

Das verwirrt nicht erst seit KI. Das hat immer verwirrt.

Was ein Sprachmodell versteht, verstehen auch Menschen:

✅ Konsistente Begriffe: durchgehend, vorhersehbar, ohne Überraschungen
✅ Klarer Kontext: wer macht was, wann, unter welchen Bedingungen
✅ Eindeutige Referenzen: “Klicken Sie auf ‘Speichern’ oben rechts”

KI-Kompatibilität ist kein Feature. Sie ist das Mindestmaß dessen, was Dokumentation immer hätte leisten müssen. Wer jetzt für KI optimiert, holt nach, was längst Standard sein sollte.

Klartext | Die homogene Zielgruppe ist ein Mythos

Thu, 26 Mar 2026 00:00:00 +0000

Dokumentation für „die Zielgruppe“ zu schreiben ist verlockend einfach.

Keine schwierigen Entscheidungen, keine Konflikte, kein Aufwand für Analyse. Das Problem: Diese Zielgruppe existiert nicht.

Jede Anleitung erreicht Menschen mit unterschiedlichem Wissensstand, unterschiedlichen Rollen, unterschiedlichem Zeitdruck — und unterschiedlichen Erwartungen daran, was eine Information leisten soll.

Wer das ignoriert, vereinfacht nicht die Arbeit. Er verlagert den Aufwand nur — direkt zu den Lesenden.

Die homogene Zielgruppe ist keine Arbeitsgrundlage. Sie ist eine Vereinfachung, die wir uns selbst erlauben.

Kurz durchdacht | Guter Kontext ist selektiv

Thu, 19 Mar 2026 00:00:00 +0000

Alle sagen: „Gib dem LLM mehr Kontext.“ Niemand fragt: „Ist es der richtige?“

Der häufigste Fehler beim Arbeiten mit LLMs ist nicht zu wenig Kontext – sondern Kontext, der irrelevant, widersprüchlich oder veraltet ist. Mehr hilft nicht, wenn es in die falsche Richtung führt.

Was passiert dann? Das LLM gewichtet alles gleich, weil es nicht unterscheiden kann, was wichtig ist. Alte Informationen überschreiben neue. Widersprüche erzeugen Halluzinationen. Die Antwort wird vage, weil sie allen Informationen gleichzeitig gerecht werden will.

❌ 200-Seiten-Handbuch für eine Einzelfrage → LLM sucht die Antwort zwischen irrelevanten Kapiteln
✅ Die drei relevanten Seiten → klare Grundlage
❌ API-Dokumentation Version 2.0 und 3.5 gleichzeitig → LLM mischt deprecated und aktuelle Methoden
✅ Nur die aktuell genutzte Version → eindeutige Basis
❌ Firmengeschichte + Produktkatalog + Organigramm für eine Support-Anfrage → LLM verliert sich in Details
✅ Nur die Produktinformationen zur konkreten Anfrage → fokussierte Antwort

Die Frage ist nicht, was relevant sein könnte, sondern was definitiv relevant ist – und zur Lösung des Problems beiträgt.

Guter Kontext funktioniert wie gute Dokumentation: So viel wie nötig, so wenig wie möglich.

Qualität schlägt Quantität. Immer.

Klartext | Füllwörter kosten Aufmerksamkeit

Mon, 16 Mar 2026 00:00:00 +0000

Füllwörter kosten Aufmerksamkeit. Und die ist endlich.

Das Gehirn filtert — aber es will das nicht tun müssen.

Kurz durchdacht | Reihenfolge von Handlungsanweisungen

Thu, 12 Mar 2026 00:00:00 +0000

„Starten Sie das System neu, nachdem Sie die Konfiguration gespeichert haben.“ Leute starten neu. Ohne zu speichern.

Gegen die Leserichtung formulierte Anweisungen werden in Leserichtung befolgt. Was zuerst im Satz steht, wird zuerst getan – unabhängig von “nachdem”, “sobald” oder “bevor”.

Typische Fehlerquellen:

❌ “Starten Sie das System neu, nachdem Sie die Konfiguration gespeichert haben.” → System wird neu gestartet. Konfiguration weg.
❌ “Klicken Sie auf ‘Weiter’, sobald der Upload abgeschlossen ist.” → Klick auf ‘Weiter’. Upload bricht ab.
❌ “Schließen Sie das Fenster, nachdem Sie die Datei gelöscht haben.” → Fenster zu. Datei unzugänglich. Fehler.

Menschen folgen der Leserichtung. Immer.

Chronologisch formuliert:

✅ “Speichern Sie die Konfiguration. Starten Sie dann das System neu.”
✅ “Warten Sie, bis der Upload abgeschlossen ist. Klicken Sie dann auf ‘Weiter’.”
✅ “Löschen Sie die Datei. Schließen Sie dann das Fenster.”

Falsche Reihenfolge führt zu falschen Handlungen.

Gute Dokumentation beschreibt nicht nur richtig – sie verhindert Fehler.

Mittagspause | Gute Dokumentation ist wie gute Luft

Mon, 09 Mar 2026 00:00:00 +0000

„Diese Anleitung hat mir den Tag gerettet!“ Wann hast Du das zuletzt gehört? Vermutlich nie.

Gute Dokumentation ist wie gute Luft – man bemerkt sie nur, wenn sie fehlt.

Niemand lobt die Anleitung, die funktioniert hat. Aber jeder erinnert sich an die, die es nicht tat. Je besser wir sind, desto unsichtbarer wird unsere Arbeit.

Das ist das Paradox: Exzellenz bedeutet Unsichtbarkeit.

Dabei steckt hinter dieser Unsichtbarkeit oft die präziseste Arbeit. Jedes Wort abgewogen, jede Struktur durchdacht, jede Zielgruppenperspektive eingenommen.

Stille Expertise schafft reibungslose Erlebnisse – auch wenn niemand klatscht. 👏

Kurz durchdacht | Information Overload

Thu, 05 Mar 2026 00:00:00 +0000

Mehr Dokumentation ist nicht bessere Dokumentation.

Viele Redaktionen dokumentieren aus Reflex: Was möglich ist, wird erklärt. Jede Funktion bekommt eine Seite. Jeder Parameter eine Tabelle. Vollständigkeit als Ziel.

Das Ergebnis: Nutzer finden nichts mehr.

Was als umfassende Dokumentation gedacht ist:

❌ Getting Started mit 20 Screenshots für eine 3-Klick-Aufgabe
❌ Feature-Übersichten mit allen Optionen statt der wichtigsten
❌ Troubleshooting-Listen mit 50 Fehlermeldungen ohne Priorisierung

Das Problem ist nicht zu wenig Information. Das Problem ist zu viel Rauschen.

Dokumentation, die fokussiert:

✅ Getting Started mit den 3 kritischen Schritten – Details verlinkt
✅ Feature-Übersicht mit den 5 wichtigsten Use Cases – Rest optional
✅ Troubleshooting mit den 3 häufigsten Problemen – andere durchsuchbar

Weniger Text, mehr Orientierung.

Gute Dokumentation ist nicht vollständig. Sie ist relevant.

Kurz durchdacht | Negative Formulierungen

Thu, 26 Feb 2026 00:00:00 +0000

Verneinungen in Anleitungen werden nicht gelesen. Sie werden missverstanden.

Unter Zeitdruck verarbeitet das Gehirn “nicht” schlechter als alles andere im Satz. Was bleibt, ist die Handlung – nicht die Warnung davor.

Aus Software-Dokumentationen kennt das jede:r:

❌ “Klicken Sie nicht auf ‘Weiter’, bevor die Konfiguration abgeschlossen ist.”
❌ “Dieses Feld nicht leer lassen.”
❌ “Den Browser während des Updates nicht schließen.”

Niemand liest das falsch. Aber viele handeln falsch.

Der Wechsel ist simpel:

✅ “Schließen Sie die Konfiguration ab, dann klicken Sie auf ‘Weiter’.”
✅ “Pflichtfeld – bitte ausfüllen.”
✅ “Update läuft – Browser geöffnet lassen.”

Gleicher Inhalt. Andere Wirkung.

Gute Dokumentation beschreibt nicht, was falsch ist – sie zeigt, was richtig ist.