Entwickler lesen den Text aus dem häufigsten Grund nicht,
nicht weil der Inhalt falsch ist.
In den meisten Fällen,
weil die gesprochene Sprache anders ist.
Entwickler sprechen die Sprache der Technik,
Leser verstehen die Sprache des Lebens.
Wenn diese Kluft nicht überwunden wird,
auch wenn der Inhalt gut ist,
bleibt er den Menschen nicht.
Menschen erinnern sich nicht an Code
Sie erinnern sich an Situationen
Du hast wahrscheinlich einen solchen Text gesehen.
"Diese Funktion hat eine O(n) Komplexität."
"Diese Struktur ist skalierbar."
"Diese Methode ist effizienter."
Das sind keine falschen Aussagen.
Aber nach ein paar Tagen
erinnert sich fast niemand an den Inhalt dieses Textes.
Im Gegensatz dazu bleiben solche Sätze.
"Kann dieser Code mich retten,
wenn der Server um 3 Uhr morgens abstürzt?"
In diesem Satz
gibt es keine komplizierte technische Erklärung.
Aber es gibt eine Situation.
Menschen verstehen
nicht durch Technologie, sondern durch Situationen,
und erinnern sich durch Situationen.
Gemeinsamkeiten guter Entwickler-Texte
Wenn man gut lesbare Entwickler-Texte genau betrachtet,
gibt es gemeinsame Merkmale.
- Die Situation wird vor dem Code erwähnt.
- Der Kontext wird vor der Funktionsbeschreibung betont.
- Die Gründe für die Auswahl werden stärker betont als die richtige Antwort.
Mit anderen Worten, es fließt so.
Situation → Überlegung → Entscheidung → Auswahl → Ergebnis
Diese Struktur
ist eher einer Geschichte als einem technischen Blog ähnlich.
Und Geschichten
sind die Form, die der menschliche Verstand am besten aufnimmt.
Technologie in die Sprache des Lebens zu übersetzen
Technologie in die Sprache des Lebens zu übersetzen bedeutet nicht,
schwierige Wörter einfach zu erklären.
Es ist eine Verschiebung der Perspektive.
Lass uns ein Beispiel betrachten.
- "Diese API ist nicht RESTful."
"Diese API zwingt Anfänger dazu,
die Dokumentation immer wieder zu überprüfen.""Diese Struktur hat eine hohe Kopplung."
"Diese Struktur bricht an mehreren Stellen zusammen,
wenn an einer Stelle Änderungen vorgenommen werden.""Die Leistung wurde optimiert."
"Auch wenn der Datenverkehr zunimmt,
kann ich jetzt schlafen gehen."
Es geht nicht darum, technische Begriffe zu eliminieren.
Es zeigt vielmehr die 'Veränderungen in der Realität', die die Technologie hervorbringt.
Warum diese Methode stark im Branding ist
Technologiezentrierte Texte
haben immer viele Konkurrenten.
Jemand anders hat es vielleicht
besser organisiert,
ausführlicher geschrieben,
schneller erklärt.
Aber die Situation, die du erlebt hast, ist nicht replizierbar.
- In welchem Kontext hast du dieses Problem getroffen?
- Warum war diese Auswahl notwendig?
- Wie hat diese Auswahl dein Leben verändert?
Nur du kannst das schreiben.
Deshalb wird ein technischer Text, der in die Sprache des Lebens übersetzt wurde,
nicht verglichen
und nicht ersetzt.
Der Moment, in dem der Leser denkt: "Oh, das betrifft mich"
Branding
ist abgeschlossen, wenn die Leute so etwas sagen.
"Die Texte dieser Person
spiegeln immer meine Situation wider."
Wenn dieser Satz fällt,
unabhängig von der Tiefe der Technologie,
kehren die Menschen immer zurück.
Weil
dieser Text nicht Informationen gibt, sondern
sich selbst beleuchtet.
Versuchen wir es so zu schreiben
Bevor du schreibst,
stelle diese Fragen.
- Wann war der Moment, in dem diese Technologie benötigt wurde?
- In welchem Zustand hat mich diese Auswahl herausgeholt?
- Was war der Unterschied vor und nach der Einführung?
Und beginne den Satz so.
- "Das, was mich am Anfang am meisten beunruhigte, als ich das einführte, war..."
- "Der Tag, an dem ich mich entschied, diese Funktion zu erstellen, war..."
- "Der Grund für die Wahl dieser Struktur war einfach..."
Wenn du so schreibst,
weicht die Technologie natürlich zurück,
und die Geschichte tritt in den Vordergrund.
Im nächsten Text
Im nächsten Text
werden wir diskutieren,
wie man diese angesammelten Geschichten
wo und wie man sie stapeln sollte, um eine Marke zu werden.
Warum es nicht die Antwort ist, viele Plattformen zu nutzen,
warum man eine 'Hauptbasis' haben sollte,
und warum Branding
kein Streuspiel ist, sondern
ein Spiel der Akkumulation.
Lass uns im nächsten Text fortfahren.