Diskussion:Guter Stil
Anrede des Lesers
Im Text steht momentan: "Sie ist wenn möglich in der zweiten oder dritten Person geschrieben, damit andere leichter an der Seite weiterarbeiten können."
Das finde ich etwas unklar bzw. nicht ausreichend. Erstens gibt es zwei Personen, von denen man in einem Artikel häufig sprechen wird: Hostsharing und den Leser. Von Hostsharing können wir meiner Meinung nach sowohl in der ersten Person Plural sprechen ("Wir bieten die Möglichkeit, ...") als auch in der dritten Person ("Hostsharing bietet die Möglichkeit, ..."). Je nachdem, was stilistisch besser passt, sollte der Autor die passende Form wählen.
Bei der Ansprache des Lesers gibt es schon ein paar mehr Möglichkeiten:
- Erste Person Plural ("Autor-und-Leser-Wir"), zum Beispiel: "Um einen neuen Benutzer anzulegen, geben wir auf der Kommandozeile xyz ein."). Nachteil: Gefahr der Verwechslung mit dem Wir, das sich (nur) auf Hostsharing bezieht; Gefahr, dass die Formulierung den Leser vereinnahmt.
- Zweite Person Du: "Um einen neuen Benutzer anzulegen, gibst Du auf der Kommandozeile xyz ein". Vorteil: entspricht dem üblichen Schreibstil auf unseren Mailinglisten. Nachteil: manche Anwender möchten nicht geduzt werden, die Dokumentation ist für Reseller nicht direkt verwendbar.
- Zweite Person Sie: "Um einen neuen Benutzer anzulegen, geben Sie auf der Kommandozeile xyz ein". Vorteil/Nachteil genau umgekehrt zum Du.
- Dritte Person: "Um einen neuen Benutzer anzulegen, gibt {man | der Paketadmin} auf der Kommandozeile xyz ein". Vorteil: neutral, Nachteil: unpersönlich.
Momentan werden in der Dokumentation alle diese Formen (außer "Sie") verwendet, teilweise sogar alle innerhalb eines Artikels, außerdem ziemlich häufig das Passiv. Ich denke, dass wir uns zumindest zwischen Wir, Du und Sie als Ansprache für den Leser entscheiden sollten, oder ganz auf die dritte Person beschränken. Oder wir legen uns nicht fest und halten es nur innerhalb eines Artikels konsistent.
Ich neige momentan dazu, das Du zu bevorzugen (plus Dritte Person und Passiv bei Bedarf).
Meinungen dazu?
--Jrs00-wiki 23:18, 20. Feb. 2009 (UTC)