LinuxTag Chemnitz 2004

[6. Chemnitzer Linux-Tag]

Die Orangerie Die Orangerie


Workshop - "Message Editing"

Abstract

Jeden Tag verfassen wir Nachrichten - entweder als Email fuer einen privaten Empfaenger oder auch fuer viele, zumeist fuer eine Mailingliste oder fuer eine Newsgruppe.

Gute Nachrichten sind vor allem gut *lesbare* Nachrichten. Das Ziel dieses Workshops ist es die Techniken kennenzulernen um die eigenen Nachrichten *lesbar* zu gestalten.

Leider werden oftmals viele Nachrichten wegen Eile in schlechter Form geschrieben - und die weiteren Leser muessen dann unter den Fehlern leiden, nicht nur beim Lesen, sondern vor allem beim *Beantworten* dieser Nachrichten. Denn es obliegt jedem selbst die eigene Nachricht fuer alle lesbar zu machen.

Mott: "Sei liberal in was du entgegennimmst - und konservativ in dem was du sendest."

Etwas konkreter gesagt: Der Leser soll daraus problemlos seinen Nutzen ziehen koennen und seine Antwort geben koennen ohne Reparaturen leisten zu muessen. Beim Beantworten sllte man daher das Zitierte ordnen, zusammenfassen, und meoglichst im Kontext beantworten.

Diese Techniken zu lernen kann ein Leben lang dauern und um sie zu beherrschen kann noch laenger dauern. ;-) Wir werden zusammen aber ein paar einfach Kniffe lernen mit denen man schon eine ganze Menge an Fehlern vermeiden kann.

Natuerlich muss man zum Umgang mit dem "beweglichem Text" die Anwendung eines Editors erlernen, insbesonder die Techniken zum effektiven Einfuegen und Loeschen, Verschieben von Text und das Umbrechen von zitiertem Text.

Diese Techniken will ich anhand von dem Mailer Mutt und dem Editor Vim zeigen. Natuerlich darf jeder waehrend des Kurses den Mailer und Editor seiner Wahl einsetzen. Aber das geht wahrscheinlich nur dann, wenn der Teilnehmer seinen eigenen Laptop mitbringt.

Jeder Teilnehmer soll Gelegenheit haben ueber einen Rechner sich auf dem Server einzuloggen und mithilfe von mutt+vim seine Emails ueber eine eingerichtete Mailingliste teilzunehmen. [Lokaler Verteiler ueber /etc/aliases]

Dabei sollte jeder seine Frage auf die Mailingliste senden - und ich werde sie fuer alle sichtbar beantworten.


Warum das ganze?

Ich schreibe *viele* Emails - und poste auch einige male in Newsgruppen. Und immer wieder aergere ich mich darueber, dass so viele Leute ihr Wissen in so schlechter Form darbringen, dass man ihre Texte staendig ueberarbeiten muss, um die eigene Antwort in eine ordentliche Form zu bringen.

In diesem Workshop will ich aber nicht nur aufklaeren (das waere der Inhalt eines Vortrages), sondern alle dazu auffordern mitzumachen, um zu *sehen* was man besser machen kann. Ich will dass jedermann sieht wieviel einfacher die Bearbeitung einer Nachricht werden kann, wenn man ein geeignetes Werkzeug benutzt.

Ich gehe nicht davon aus, dass jeder nach diesen drei Stunden in der Lage sein wird aus einer komplett verhunzten Nachricht eine Antwort zu geben, die fuer die Nachwelt in Stein gemeisselt werden wird. Aber ich erhoffe mir, dass ich mithilfe der Anschauung erreichen kann, dass jeder Teilnehmer dazu ermuntert wird die Nachrichten anderer beim Beantworten zu verbessern und sich zu bemuehen lesbare Nachrichten zu schreiben.

Ein kleiner Rueckblick: In Jahre 1989 erhielt ich meinen ersten Zugang zu einem UNIX Rechner. Mit diesem hatte man zugleich eine Emailadresse. Und auf einmal war da dieses "Internet"... Email flogen hin und her zwischen den Kontinenten. Und weit entfernte Menschen erschienen ploetzlich ganz nah. Seitdem war ich von diesem Medium begeistert.

Ein paar Jahre spaeter (ungefaehr Sommer 1991) kam dann das "Usenet" mit seinen "Newsgruppen" hinzu. Inzwischen gibt es im Usenet Archiv knapp 15,000 Nachrichten von mir - und ein Vielfaches davon habe ich als Email geschrieben.

Die aus den vielen gelesenen und geschriebenen Nachrichten resultierende Erfahrung moechte ich nun weitergeben und erhoffe mir davon, dass andere diese Erfahrungen nicht erst alle selber machen muessen bis sie auf den Wert von gut geschriebenen Nachrichten erkennen.


Struktur des Workshops


Neue Nachrichten

Anfang - Kopfteil (header)
Ziel:  Deutliche Unterscheindungen zu Spam geben
From:       - nie ohne Namen, möglichst mit dem eigenen Namen
Subject:    - niemals leer; sinnvolle Hauptworte, "Überschrift".
              gegebenenfalls nach dem Beeden der Mail anpassen.
Reply-To:   - ebenfalls mit Name+Adresse.  Redundanz vermeiden.
Message-ID: - Datum+Uhrzeit, Zufallszeichen, am Ende mit FQDN.
              also mit eigener Domain und Unterdomain.

Inhalt

Inhalt (body):
Guter Anfang:   Begrüssung + Unterschrift als Kennzeichung
                für Anfang und Ende der Nachricht

Exkurs: Problem+Lösung

Zusammenfassung am Anfang.  Grundfrage stellen.
Beschreibung des Problems in abstrakter Form.

Gib so viele Information wie möglich!
Was ist dein Ziel?
Was ist deine Situation? (Hardware, Software, Programme)
Gib ein Beispiel.

Treten Fehler auf?  Gibt es Fehlermeldungen?  Welche?
Kannst Du den Fehler wiederholen?

Tritt das Problem auch bei den Grundeinstellungen des Programms auf?
Oder tritt das Problem nur bei der Konfiguration aus?
Welche Einstellungen hast Du verändert bzw könnten damit zusammenhängen?

Alle grossen Daten (komplette Setupdatei, Logdateien, Screenshots)
*nicht* anhängen, sondern auf einen Webserver hochladen und nur
deren Adressen nennen.  Möglichst ein Verzeichnis für jedes Problem.

Wie gut kennst Du dich mit den Programmen aus?
Bist Du ein technischer Mensch?
Bist Du ein gelegentlicher Anwender?

Alle Fragen *deutlich* formulieren!

Wiederkehrende TextTeile -> Abkürzungen

Schnelles Einfügen von
- Emailadressen
- Webadressen (URLs, URIs)
- lange Worte
- Phrasen
- Standardtext (templates)
-> Abkürzungen und Dateien!

Vorgehensweise

Antworten schreiben

Nachrichten KOPF:
- Adressen hinzufuegen, eventuell ueber Aliase
- Subejct anpassen
  ,cs   change subject mit "X-Old-Subject: OLD"
  ,CS   Change Subject mit "Subject: NEW (was: OLD)"
- Zuweisung des Folderkopie per Fcc:
  #C    "Fcc: +CHEMNITZ"

Nachricht KOERPER:
- Zuordnung (Attribution):
  Name+Adresse - eventuell noch Datum+Uhrzeit.
  (das sollte man nur einmal einstellen muessen).
- evtl Zuordnungszeilen kuerzen bzw raparieren.

- Loeschen von Leerzeichen am Ende der Zeile.
  (gilt allerdings nicht bei "format=flowed")
  mit F9

- Loeschen von Begruessung+Unterschrift+Signatur
- Konvertierung von TABs zu Leerzeichen.

- Private Nachricht:  Begrüssung
  bei weiteren Nachricht in einer
  "Unterhaltung" eventuell weglassen.
  ,hi   "Hi!"
  ,ha   "Hello, again!"
  ;;    "Hello, FIRSTNAME!"

- Aufbrechen des Textes in Absaetze
  mit zusammenhaengendem Inhalt.
  (r[space])

- Umbrechen von zitierten Text
  CTRL-J    auf aktuelle Textbreite umbrechen
  F5        Breite um zwei Zeichen verkleinern
  F6        Breite um zwei Zeichen vergroessern

- Zusammenfassen von "Whitespace"
  (Folgen von Leerzeichen und TABs) mit F10

- Vor- und Nachteile der automatischen Behandlung
  des Textes beim Start des Editors.  (Erkennung
  von nicht zu aenderndem Text wie zB Tabellen)

Fertigkeiten des Edititierens

Folgende Kommandos sollte der Editor haben:

- Kommando "undo" ist eine unabdingbare Voraussetzung!
  Ein dazugehoriges "redo" sollte es eigentlich auch geben.
  ["Wiederherstellen von geloeschtem Text"]
  [Achtung: Webmailer haben meist *kein* "undo"!]

- Schnelles Einfuegen von lamgen Worten,
  Phrasen und Texten -> Abkuerzungen
- Kopieren und Loeschen von Textobjekten
  wie Wort+WORT, Satz bzw Absatz.
  Ersetzen des geloeschten Textes durch eine Ellipse.
- Einruecken eines Textblockes.
- Automatisches Einruecken von Einrueckung
  durch Whitespace (automatic indentation).

- Umbrechen von Text auf aktuelle Textbreite
  unter Beibehaltung der Zitatlevel!
- Breites des Textes relativ verkleinern und vergroessern
- Einfuegen eines Spoiler-Textes
- Text suchen und ersetzen - auch mit Mustern
  reg.Ausdruecken

- Operationen auf Spaltentext (rechteckiger Text).
   [zB zum Einfuegen von leeren Spalten]

- Zitieren und Dezitieren von Text
  ,qp     quote paragraph
  ,dp   deqoote paragraph

- Einfuegen von URLs aus einer Textdatei
  :r!grep http file

- Einfuegen von Zitaten
  ,aq   :r!agrep

- Einfuegen einer Signatur
  ,s    :r!agrep

- Loeschen von Vollzitaten
  dG        aktuelle Zeile bis zur letzten Zeile loeschen
  dip       aktuellen Absatz loeschen
  d/foo     Loeschen von aktueller Position bis zum naechsten Wort "foo"

(Externe) Filter:
- Box um Text machen und loeschen
- Text rotieren (caesar cipher, rot13)
- Sortieren (auch nach Nummern - (sort -n")

Verschiedenes:
- ASCII Bilder
- Smileys
- Themata im Text ("[Thema]")

Und die Anwendung dieser Kommandos sollte man auch beherrschen. ;-)

Konzeptionelles: Aufteilen von Nachrichten in veschiedene Diskussionsteile. (Mithilfe von Vims Registern und Viminfo-Ddatei kein Problem!)


Arbeitsmaterialien

Ein Rechner sollte fuer jeden Teilnehmer vorhanden sein. Ich empfehle aber jedem einen Papier+Stift mitzubringen, um Fragen zu notieren. Eventuell kann ich notierte Fragen zwischendurch noch beantworten.


LinuxBus: Berlin <-> Chemnitz

Bustransfer zwischen Berlin und Chemnitz:


Alles gelesen? Gibt es noch Fragen? Bitte schickt sie mir einfach per Email - ich freue mich über euer Feedback! Vielleicht kann ich das ja auch noch in mein Workshop mit aufnehmen. :-)

Sven Guckes chemnitz2004@guckes.net www.guckes.net/chemnitz2004/