Großes technisches Schreiben: Die Zwei-Umrandete Klinge der Leser-Erfahrung

| by Barry Millman | November 07, 2006

Überblick

Wenn wir Benutzer-Dokumente schreiben, bauen wir auf unsere Erfahrung des Lesers/des Benutzers, um unsere Arbeit zu vereinfachen. Dieses kann Probleme für den Leser verursachen. Dieser Artikel bespricht die Effekte der Lesererfahrung und wie man die negativen Effekte der inkompatiblen Erfahrung herabsetzt und wie man die Annahmen des Verfassers über den Leser anfaßt.

Nutzen des Verfassers: Bauen auf Leser-Erfahrung

Wenn wir schreiben, bauen wir auf Erfahrung unseres Lesers, um uns einen „Ausgangspunkt“ für unser Benutzer-Dokument zu geben. Häufig bilden wir versteckte Annahmen über Erfahrung unseres Lesers.

Sind hier einige Beispiele, wo, bauend auf die Sachen Marken Erfahrung unseres Lesers einfach (und verursacht Probleme), für uns als Verfasser:

Beispiel: Verwenden der Maus eines Computers

In den Schreiben Benutzer-Unterlagen für graphischer Benutzer Schnittstelle-gegründete Computerprodukte (wie Windows oder die Mac-Benutzerschnittstelle), nehmen wir an, daß der Leser eine Maus benutzen kann, um Einzelteile, Gegenkraft, etc. an zu klicken. Dieses speichert viel Hintergrundschreiben.

Beispiel: Kochen: Wie man Bestandteile mißt; Bezeichnungen

Kochbücher speichern Raum durch (normalerweise richtig) das Annehmen, daß ein Leser grundlegende kochende Betriebe durchführen kann (wie messende Bestandteile), und die Bezeichnungen (wie Püree oder Scheibe).

Beispiel: Allgemeine Akronyme

Wir bauen auf „allgemeine“ Akronyme wie morgens und P.M., um unsere Schreiben Leben zu vereinfachen. Jedoch benutzen viele Leser einen 24 Stunde Taktgeber, und folglich sind morgens und P.M. zu ihnen bedeutungslos.

Von allen möglichen Akronymen aufpassen, denen du annimmst, daß dein Leser weiß. Er ist am besten, Akronyme in der Linie zu definieren (möglicherweise in Klammern) wenn sie zuerst in diesem Teil des Benutzer-Dokumentes dargestellt werden.

Du kannst nicht sie definieren, nur das erste mal sie im Benutzer-Dokument erscheinen. Dieses nimmt an -- falsch -- dieses lasen Benutzer dein Benutzer-Dokument von Anfang zu Ende.

Problem-Verfasser verursachen, wenn sie Benutzer-Erfahrung annehmen

Unsere Annahmen als Verfasser können uns in Mühe erhalten.

Beispiel: Nicht vertraute Wörter

Hier ein ist das Im Garten arbeiten Beispiel: Erläuterter Führer des Gipfels (einer erfundenen Firma) zum Im Garten arbeiten in Kanada (1979) bildet eine falsche Annahme über seine Leser:

In einer ihrer Definitionen verwenden sie eine Bezeichnung, „das axil eines Blattes“, um eine andere Bezeichnung zu definieren. „Axil eines Blattes“ wird nicht im Index des Buches verzeichnet, und es gibt kein Glossar im Buch. Offenbar nimmt dieses Buch an, daß der Leser versteht die Bezeichnung „das axil eines Blattes.“ Ich nicht und morgens folglich, das mit der Darstellung unglücklich ist.

Lösung: Ein Glossar der im Garten arbeitenden Bezeichnungen oder einen Hinweis auf einer Seite im Buch zur Verfügung stellen, in dem die Bezeichnung definiert wird.

Beispiel: Erfahrung der anmaßenden Kursteilnehmer

Ist hier ein Beispiel, wo eine (nicht festgestellte) Annahme durch eine Training Firma einen ihrer Kurse unbrauchbar machte.

Zwecks die übungen in einem Computerprogrammierung Kurs tun, mußten Kursteilnehmer verwenden einen Herausgeber (ein einfaches Textverarbeitungsgerät) um das System zu programmieren. Der einzige Herausgeber, der auf den Kursmaschinen vorhanden ist, war ein UNIX-Herausgeber, der als VI bekannt ist.

Leider wurden die Kursteilnehmer nicht erklärt, daß sie den Herausgeber VI benutzen mußten. Die Kursvorführer nahmen an, daß die Kursteilnehmer VI kannten. Die Kursteilnehmer nicht und sie wendeten Hälfte Kurszeit auf, die versucht, VI zu erlernen und zu beschäftigen.

Die versteckte Annahme durch die Training Firma ergab eine verlassene Lernenerfahrung (die Kursteilnehmer nie benötigt, um VI wieder zu verwenden). Sie vergeudete zwei Tage der viertätigen Kurszeit.

Annahmen in einer Sneaky Weise nicht darstellen

Wenn die Training Firma die gesagt hatte, „wir bilden auf UNIX-Systemen aus,“ dann verlassen sie einen Ausweg für selbst, wenn sie Kursteilnehmer enttäuschen, die nicht den Herausgeber VI kennen. Als konfrontiert, könnte die Firma mit reagieren, „wir erklärte dir, daß es ein UNIX-System war. Du solltest wissen, daß VI der Herausgeber ist, der vorhanden ist auf diesem System.“

Diese sneaky Aussage über die Annahme ist dumm. Sie ergibt eine Verlierenverlieren Situation.

Das Endergebnis

Als Verfasser wir, zum von Annahmen über Erfahrung unseres Lesers zu bilden. Jedoch wenn du Annahmen bildest, dann überprüfen, ob du dem Leser erklärst, was du über ihn/sie annimmst.

An die Annahmen denken, die du über deinen Leser bildest. Sind diese Annahmen gültig (kannst du deine Leser das heißt, wirklich erwarten, deine Annahmen zu treffen)? Wenn es irgendeinen Zweifel in deinem Verstand gibt, die Informationen einschließen, welche die Bezeichnungen und die Verfahren, die du, erklären annimmst.

Überprüfen, ob, wenn du Annahmen angibst, das du sie in einer Weise darstellen, der der Leser (Kursteilnehmer) verstehen kann, was die Annahme zu ihnen bedeutet. Über das Darstellen der Annahmen sneaky nicht sein.

Benutzer-Erfahrung kann Mühe für Verfasser verursachen

Erfahrung deines Lesers kann Durcheinander verursachen. Sind hier einige Beispiele:

Beispiel: Shampoo-/Conditioner-Produkt

Eins meiner Lieblingsbeispiele ist ein kombiniertes Haarshampoo- und -conditionerprodukt. Wenn ein Benutzer Erfahrung mit den unterschiedlichen Produkten hat, dann ist ihre Erfahrung:

* Shampoo: Nasses thenhair. Massageshampoo in das Haar, spülen es dann heraus aus.
* Conditioner: Das Haar waschen. Conditioner in das nasse Haar massieren, im Haar für zwei oder drei Minuten verlassen, dann es heraus ausspülen.

Das Problem entsteht mit dem kombinierten Produkt. Sollte der Benutzer das Produkt im Haar für zwei oder drei Minuten lassen (wie mit dem Conditioner getan), oder ihn sofort ausspülen (wie mit dem Shampoo getan)?

Das Benutzer-Dokument (Produktaufkleber) für einen kombinierten Shampooconditioner sollte dem Benutzer erklären, wie man zwei--ein im Produkt verwendet. Die meisten solchen Aufkleber nicht.

Beispiel: Wörter verwendet in unerwarteten Weisen

Dein Schreiben kann die Erwartungen des Lesers, mit dem Ergebnis des Durcheinanders einstellen, wenn Wörter unerwartet verwendet werden.

Ein Artikel im Technologie-Abschnitt (einer Zeitung der am 10. Juni 2004, Seite B14) beschrieben, „, wie der kleine Kerl Computerdaten unterstützen kann“. Der Artikel war über Computer. Als ich zum Satz kam: „Lassen Sie uns ihn gegenüberstellen: Unterstützungen bohren und ein Streit, um aufzuladen.“ Ich wunderte mich über die Phrase „, um aufzuladen.“

In der Computerfachsprache „Aufladung“ ist der Prozeß, in dem der Computer oben beginnt („Heber selbst durch seine Stiefelriemen“… durch ein Programm benannten ursprünglich ein „Urleseprogramm“). Lädt der Anführungsstrich des Autors über „den Streit“ Mittel auf, das, wenn ich Unterstützungen, dann tue meinen Computerwillen langsamer sein („bohrend“) und mehr Arbeit von mir erfordern, oben zu beginnen („aufzuladen der Streit“)?

Der Gebrauch von der Phrase „zur Aufladung“ ist in diesem Artikel nicht angebracht, angenommen, „zur Aufladung“ mehrfache Bedeutungen hat. Der Autor verwendete ihn als Jargon für „zusätzlich zu.“ Da der Artikel über Computer war, dachte ich an die Computerbedeutung von „, um aufzuladen.“ Der Satz würde, wenn der Autor „zur Aufladung ausließ,“ wie weniger verwirrend sein: „Lassen Sie uns ihn gegenüberstellen: Unterstützungen bohren und ein Streit.“ Wir kommen zu diesem Beispiel kurz zurück.

Beispiel: FunktionsFixedness

Die Funktion eines Gegenstandes wird im Verstand einer Person geregelt. Z.B. ist die Funktion eines Hammers, Sachen zu zerstoßen. Experimente haben gezeigt, daß Leute eine harte Zeit mit einem Hammer für eine ungewöhnliche Funktion, wie einen Papierbeschwerer, eine Stütze oder einen Hebel haben. Dieses wird Funktionsfixedness genannt.

Funktionsfixedness kann die Verwendungsfähigkeit deines Produktes begrenzen. Dein Benutzer-Dokument sollte versuchen, Funktionsfixedness zu überwinden. Möglicherweise zeigt dieses Beispiel, wie kritisch ich von den Benutzer-Dokumenten bin.

Ich habe eine Handgelenkglobale in Position bringende Satelliten (GPS) Vorrichtung, die meine langen Wege verfolgt. Die Strickjacken und schwere Mäntel, die für das Gehen in den Winter erforderlich sind, bilden es schwierig, die GPS Vorrichtung auf dem Handgelenk zu tragen. Aber es ist eine HANDGELENK-Vorrichtung. Funktionsfixedness entsteht und veranlaßt mir Kampf, den GPS auf meinem Handgelenk zu verwenden. Aber es fällt aus, daß die GPS Arbeiten hervorquellen, wenn sie in einer Tasche verwendet werden.

Das GPS Benutzer-Dokument sollte dieses erwähnen (offensichtlich?) Fähigkeit, das Funktionsfixedness so verringernd verband mit dem HANDGELENK GPS. In meiner Verteidigung: Ich bin nicht sicher, daß, das Handgelenk GPS in eine Tasche einzusetzen auf der Hand als mit einem Hammer als Papierbeschwerer liegt.

Beispiel: Stimmung

Stimmung baut an:

. ein subtiles Wissen der Sprache (z.B. ein Wortspiel)
. oder ein Wissen eines Falls (möglicherweise ein gegenwärtiger Fall oder Unterhaltung Fall)

auf, welchem die Stimmung basiert. Ist hier ein Beispiel, von einem alten Witz:

„Du bist, also lustig, solltest du auf einem Stadium sein. Es gibt ein, das verläßt in 15 Minuten.“

Dieser Witz beruht auf dem Leser, der die zwei Bedeutungen „des Stadiums“ kennt: (1) ein Platz für das Durchführen und (2) Transport benutzt in den Westvereinigten staaten im 1800's. Die meisten Leser konnten nicht die zweite Bedeutung kennen und die Stimmung übertragen eine verwirrende Vergeudung von Wörtern.

Früh überprüften wir den Satz: „Lassen Sie uns ihn gegenüberstellen: Unterstützungen bohren und ein Streit, um aufzuladen.“ Der Autor verwendete die Phrase „, um als irgendeine Form des geselligen Gespräches oder der Stimmung aufzuladen“. Sie verwirrte den Leser.

Stimmung von deinem Benutzer-Dokument beseitigen

. Stimmung verwirrt nur Benutzer, die sie nicht verstehen.
. Stimmung ist schwierig, wenn nicht unmöglich, in andere Sprachen zu übersetzen.

Ich schlage vor, daß du eine Schreibweise, die formlos und Unterhaltungs ist, aber ohne Versuche an der Stimmung verwendest. Versuche an der Stimmung entfernen, wenn du dein Schreiben wiederholst und verbesserst.

Wenn du Stimmung schreiben möchtest, sie anderwohin tun (du solltest auf einem Stadium sein). Benutzer-Dokumente sind kein Platz, zum deiner Stimmung zu üben.

Das Endergebnis

Annahmen

Achtgeben über, was du über deinen Leser annimmst. Wenn im Zweifel, ob oder nicht ein Leser etwas weiß:

. Deine Annahmen über deinen Leser angeben
Die Annahmen in einer Weise angeben, der der Leser beziehen kann auf
. Wenn im Zweifel, die Informationen addieren, die du annimmst, oder
. Deinem Leser erklären, wo man die angenommenen Informationen findet
Indem Sie auf diese angenommenen Informationen zur Verfügung stellen oder zeigen, erhöhst du deine Publikum

Erfahrung der Leser

Berücksichtigen wie Einflüsse Erfahrung deines Lesers, wie he/she dein Benutzer-Dokument deutet oder dein Produkt benutzt. Material deinem Benutzer-Dokument bei Bedarf hinzufügen, um inkompatibler Erfahrung deines Lesers zu widersprechen.

Article Source: http://www.articleset.com



About the Author

Barry Millman, Ph.D., has a Bachelor of Science in Electrical Engineering (1966, Carnegie Institute of Technology) and a M.Sc. and Ph.D. in Psychology (Human Information Processing, University of Calgary). He has been a consultant for over 25 years, an instructor, course developer, and award-winning speaker. For the past seven years he has been researching and creating resources to help organizations create great User Documents.

Visit: http://www.greatuserdocs.com for resources to help you create the content and access that your Users want and need.

» Read more articles by Barry Millman
You are welcome to publish or reprint this article free of charge, provided: