Viele Leute glauben, dass, um ein guter Technischer Schriftsteller zu sein, müssen Sie ein Thema-Experte sein. Und obwohl dies ein häufiges Missverständnis ist, ist es keine Überraschung, dass die Leute halten diesen Glauben. Schließlich ist Ihre Aufgabe als technischer Schriftsteller, komplexe, technische Informationen an ein Publikum in einer Weise zu kommunizieren, die leicht zu verdauen ist. Glücklicherweise ist die Realität, dass Sie kein KMU sein müssen, um einen technischen Artikel der Weltklasse zu schreiben. Notwendigkeit ist Neugier, Struktur und die Bereitschaft, einem Fachmann die richtigen Fragen zu stellen, und das ist die Schönheit des technischen Schreibens: Die richtigen Fragen zu stellen ist wichtiger als alle Antworten zu haben. Dau Der Non-SME-Führer zu einer großen technischen Geschichte 1. Brandish Dein Mangel an Know-how wie die Waffe es ist Das fehlende Fachwissen, über das Sie sich so viel Sorgen machen, gibt Ihnen einen interessanten Vorteil – die Möglichkeit, sich dem Thema mit dem gleichen Gefühl zu nähern und Sie stellen die Fragen, die Experten vergessen zu fragen (diejenigen, die Ihre Leser auch leise fragen), fragen jedes Konzept, brechen Jargon in einfache Sprache ab und füllen Ihre eigene Wissenslücken, geben dem Leser die beste Erfahrung. greenness curiosity https://ucatt.arizona.edu/news/curse-knowledge?embedable=true 2. Eine Beziehung mit einem Fachmann aufbauen Wir haben festgestellt, dass Sie kein KMU sein müssen, um eine großartige technische Geschichte zu schreiben, aber Und du musst eine Beziehung mit dieser Person (oder Ressource) aufbauen. du brauchst eine Verbindung mit den Gehirnen hinter dem technischen Projekt / Thema, über das du schreibst. someone Ihre Aufgabe ist es dann, eine Brücke zwischen den Erkenntnissen dieser Person und Ihren Lesern zu sein. Aber hier ist die Sache über KMU: Sie leben oft tief in der Komplexität ihrer eigenen Systeme. Sie sind da, um diese Erkenntnisse herauszuholen und sie in etwas zu übersetzen, das reist. Vertrauen Sie darauf, dass Sie ihre Arbeit präzise darstellen, nachdenkliche Fragen stellen und ihre Zeit mit Respekt behandeln. build trust. Wie man mit KMU kommuniziert Machen Sie Ihre Hausaufgaben zuerst. erscheinen Sie nicht bei einem KMU-Treffen leer. Lesen, recherchieren und kommen Sie mit spezifischen, intelligenten Fragen vorbereitet. Fragen Sie „warum“ mehr als „was“. Das „was“ sagt Ihnen, was gebaut wurde; das „warum“ sagt Ihnen, für wen es ist und warum es zählt. Klären Sie die Terminologie sofort. Nicht falsch verstehen. Missbrauch von Begriffen in einem technischen Stück kann die Glaubwürdigkeit ruinieren. Senden Sie eine kurze Fortsetzung mit dem, was Sie verstanden haben, und stellen Sie sicher, dass Sie auf der gleichen Seite sind. 3. Übersetzen, nicht übersetzen Wenn du bereit bist, den Stift auf das Papier zu legen, musst du dir daran erinnern, dass deine Aufgabe nicht darin besteht, den Jargon eines Experten auf die Seite zu werfen. In der Praxis bedeutet dies, den Jargon auf einfache Sprache zu streichen. Der Leser wird von dem Produkt / der Dienstleistung beeinflusst, anstatt von der ganzen interessanten Technologie, die es erzeugt. wie Anstatt zu sagen, Sagen Sie, "Das Produkt XYZ ist großartig, weil es mit modernster, erstklassiger Blah Blah gebaut wurde." "Produkt XYZ, gebaut mit modernem blah blah, ist großartig, weil es Ihnen hilft, ABC zu tun." Sehen Sie den Unterschied? Die erste Zeile flachtert die Technologie. die zweite dient dem Leser. Am Ende des Tages bauen Sie eine Brücke zwischen Fachwissen und alltäglichem Verständnis.Je klarer die Brücke, desto mehr Menschen können sie überqueren. 4. Fact-Check wie Ihr Leben hängt davon ab Dies ist nicht optional, vor allem für Nicht-KMU. Technische Geschichten hängen von der Genauigkeit ab. Im Gegensatz zu Prosa müssen Ihre Fakten zu 100% wahr und verifizierbar sein, Ihr Code MUST funktionieren und Ihre Beispiele MUST reproduzierbar sein. Führen Sie alles aus – Screenshots, Code-Snippets und Statistiken – zurück zu Ihrem Experten für Bestätigung. Erzählen Sie die Geschichte (Keyword, „Story“) Sobald Sie die Fakten überprüft haben, bauen Sie die Geschichte auf. Am Ende des Tages ist das technische Schreiben immer noch . Schreiben Und das bedeutet, dass es Struktur, Fluss und Auszahlung braucht. (das Problem oder das Ziel), entfalten Sie die (Ihr Prozess oder Entdeckung) und in der Nähe der (Bewusstsein oder Aktion) why how what next Um die Dinge einfacher zu machen, haben wir einen praktischen Leitfaden auf der Grundlage dieser genauen 3-Akts-Struktur erstellt. Beginnen Sie mit ihm hier: Technische Storytelling Writing Template. Get started with it here: . Technical Storytelling Writing Template Technische Storytelling Writing Template Schreiben Sie, als ob Sie es einem Freund erklären würden, und wenn Sie jemals vergessen, wo Sie anfangen sollten, denken Sie daran, dass Klarheit die Komplexität jedes Mal überwindet. Wir hoffen, dass dies Ihnen etwas Klarheit (und Ihre Ängste) über die Navigation in der Technischen Schreibindustrie ohne Fachwissen gegeben hat. Bis zum nächsten Mal!
