Brad Frosts Artikel „Nur“ von vor ein paar Jahren hat eine neue Nervengrenze getroffen. Es ist ein einfaches Wort, das leicht herausrutschen kann und das vielleicht verwendet wird, um Text locker klingen zu lassen, aber das Ergebnis kann schädlich sein. Brad
Die Menge an verfügbarem Wissen in unserem Bereich (oder eigentlich in jedem Bereich) wächst ständig, wird komplexer und segmentierter. Dass jeder die gleichen grundlegenden Kenntnisse zu einem Thema heruntergeladen hat, wird immer unwahrscheinlicher. Aus diesem Grund müssen wir vorsichtig sein, nicht zu viele Annahmen in unseren Dokumentationen, Blogbeiträgen, Tutorials, Wikis und Mitteilungen zu treffen.
Stellen Sie sich vor, Sie erklären eine bestimmte Aufgabe einer früheren Version von sich selbst. Einst wussten Sie nicht, was Sie jetzt wissen. Geben Sie Kontext. Das Schöne am Hypertext ist, dass wir schnell den dringend benötigten Kontext hinzufügen können, der für Anfänger hilfreich ist, aber für diejenigen, die bereits informiert sind, leicht zu überfliegen ist. Und die Dokumentation menschlicher lesbar zu machen, kommt allen zugute.
Ethan Marcotte geht diesen einen Schritt weiter
Ich habe in unserer Branche einen rhetorischen Trope bemerkt. Er ist nicht, ähm, *weit verbreitet*, aber ich sehe ihn in genügend Blogbeiträgen und Konferenzvorträgen, dass ich denke, es ist ein ziemlich gängiges Muster: nämlich, dass der Autor dem Leser einen Rat gibt und, wenn der Chef oder die Stakeholder des Lesers einen bestimmten Handlungsverlauf nicht unterstützen, vorschlägt, dass der Leser „es einfach trotzdem tun soll“.
Ich denke, das ist ein schlechter, schädlicher Trope. Und ich denke auch, wir sollten ihn vermeiden.
„Nur“ ist heimtückischer als das offensichtlich schmerzhaftere „Offensichtlich“ oder „Einfach“. Tatsächlich gibt es eine ganze Liste von Wörtern, die vermieden werden könnten. Das Ergebnis der Nichtverwendung solcher Wörter? Klarere Sätze und inklusivere Schreibweise. Möchten Sie etwas bewirken? Seien Sie wie Jeremy Keith und reichen Sie Pull Requests ein, wenn Sie die Gelegenheit sehen.
Die besten Lehrer, die ich hatte, waren diejenigen, die vorsichtig waren, mich nicht dumm fühlen zu lassen.