Hilfe:Wiki/Artikel

Aus SELFHTML-Wiki
< Hilfe:Wiki(Weitergeleitet von Hilfe:Artikel)
Wechseln zu: Navigation, Suche

In diesem Bereich werden Informationen zu inhaltlichen Gliederung und Gestaltung eines Artikels gegeben. Ein weiterer Bereich informiert sie, wie Sie Artikel mit MediaWiki formatieren.

Arten von Artikeln

Im SELFHTML-Wiki gibt es (in inhaltsverzeichnenden Seiten) prinzipiell drei verschiedene Ausrichtungen, die ein Artikel haben kann.

Referenzen sind systematische, meist tabellarische Übersichten für Leser, die sich in dem jeweiligen Bereich gut auskennen und nur etwas nachschlagen möchten.

Im Glossar werden Fachbegriffe kurz erläutert und weiterführende Links unter Siehe auch oder Weblinks zur Verfügung gestellt.

Tutorials führen in Form von Schritt-für-Schritt-Anleitungen in ein Thema oder einen Teilbereich ein.

Sie bauen insgesamt aufeinander auf, sodass im ersten Absatz auf zum Verständnis benötigte Tutorials verlinkt werden sollte.

Hinweis:
Die Artikel werden inhaltlich in ihren jeweiligen Bereichen einsortiert - eine Unterscheidung nach Artikelarten wird nicht mehr vorgenommen.

Wie sehen gute Tutorials aus?

Gute Tutorials

… erstellt man nicht von heute auf morgen. Anders als Blog-Beiträge, die nach hinten rutschen und dann langsam vergessen werden, bleiben Wiki-Tutorials (hoffentlich) immer auf dem neuesten Stand, wenn Nutzer im Wiki aktiv mitmachen und diese ständig verbessern.

sind Selbstlerneinheiten,[1] bei denen Nutzer den Artikel und die darin enthaltenen Beispiele nach dem SELF-Motto „Energie des Verstehens“ eigenständig durcharbeiten können.

Dennoch sollten bei der Neuanlage von Tutorials einige Grundsätze berücksichtigt werden.[2] Sie sollten neue Inhalte zunächst im eigenen Benutzernamensraum erstellen. Also etwa Benutzer:Dein Benutzername/neue Seite. Erst wenn der Artikel zum großen Teil fertiggestellt und im Forum vorgestellt und durch "Peer Review" abgesegnet wurde, sollte er an die „richtige“ Stelle in der Dokumentation verschoben werden.


Empfehlung: Wenn ein Tutorial nun gar nicht mehr aktualisiert und überarbeitet werden kann, wird es nicht gelöscht, sondern depubliziert: d. h. durch eine Weiterleiung auf die entsprechende Portalseite ersetzt. So kann die Versionsgeschichte weiterhin eingesehen werden.
--Matthias Scharwies (Diskussion) 07:18, 25. Apr. 2023 (CEST)

Vorüberlegungen

Wie beim Erstellen von Unterricht und Prüfungen gilt auch hier, dass eine gründliche Vorbereitung spätere Nachfragen reduziert.

Formulieren Sie für sich …

  • 1-2 Lernziele
  • die Zielgruppe und …
  • das benötigte Vorwissen
  • das Ziel als fertige Beispiel

Einleitung

Tutorials sollten mit einer kleinen Einleitung beginnen, die den hervorgehobenen Haupttitel (in der Wikipedia Lemma genannt) der Seite enthält. An dieser Stelle braucht keine Überschrift gesetzt zu werden, der Seitentitel wird zur Hauptüberschrift.

Sie stecken in einem kurzen einleitenden Abschnitt zuerst das Thema ab, eventuell auch abgrenzend von anderen Dingen. Sie erwähnen, warum ein Thema relevant ist, wen es angeht, und werden dann immer spezifischer.

Lesedauer, Anspruch und benötigtes Vorwissen sollten schon in der Vorlage:Text-Info angegeben werden.

Inhalt

Leser befinden sich zumeist in einer anderen Wissens-Umgebung als der Autor im Moment des Schreibens. Als Schreibender ist man "voll im Stoff" und neigt schnell dazu, das eigene Wissen beim Leser vorauszusetzen. Also bitte nicht mit der Tür ins Haus fallen.

Aber nicht jedes Tutorial muss den head eines HTML-Dokuments oder die Einbindung von JavaScript erklären, sondern reduziert den Inhalt auf die festgelegten Lernziele (Didaktische Reduktion)[3]. Verweisen Sie auf bereits bestehende Tutorials, bzw. Referenzen und gehen gleich in medias res. Konsultieren Sie auch die Glossar-Liste und verlinken Sie das erste Aufkommen eines Begriffs mit bestehenden Glossareinträgen.

sachliche Richtigkeit

Gute Tutorials zeigen nicht ein direkt einsetzbaren Code-Schnipsel, sondern erklären die verwendeten Komponenten und den Weg zum fertigen Beispiel.

Dabei sollten selbstverständlich die Grundsätze des Webdesigns eingehalten werden:

Häufig werden Tutorials kürzer und verständlicher, wenn sich anfangs Gedanken über die Barrierefreiheit gemacht und dann gleich passende Elemente verwendet werden anstatt die Funktionalität erst nachträglich mit weiterem Code hinzuzufügen.

Strukturierung

Eine gute Strukturierung erzielt man, indem man die Inhalte in Abschnitte mit aussagekräftigen Überschriften gliedert.

Sie können durchaus Überschriften mehrerer Ordnungen verwenden. Achten Sie aber auf eine logische Folge. 20 Hauptüberschriften wirken weniger geordnet als wenige Hauptüberschriften mit jeweils mehreren Unterüberschriften. Diese Überschriften bilden dann die verschachtelte Liste des Inhaltsverzeichnisses, das dem Leser einen ersten Überblick verschafft.

Quellenangaben

Ein absolut guter Artikel im SELFHTML-Wiki braucht keine Quellenangaben, er wird zitiert :-)

Empfehlung: Geben Sie Quellen mit Fußnoten an und verweisen Sie am Ende auf weiterführende Weblinks.

Quellenangaben erfolgen in einem letzten Abschnitt des Artikels in der Form :
Name des Autors, Titel, Verlag [,Auflage], ISBN-Nummer.
Die Mediawiki-Software interpretiert die ISBN-Nummer ohne weiteres als Link und verweist auf eine Auswahl an Online-Buchhändlern. Beispiel: Olaf G. Koch, Windows NT4 Kompendium, Markt & Technik, ISBN 3-8272-5304-7.

Fußnoten werden mit
<ref>Quellenangabe</ref>
im Fließtext notiert.

(Weiterführende) Weblinks werden nach der Verlinkung kurz erläutert:

Besim Karadeniz: Verstehen Sie mal das Internet!
Eine hervorragend gemachte Seite mit allgemeinverständlichen Erläuterungen zum Internet, TCP/IP, Adressierung und Tools. Nicht nur für Anfänger. Vielen Dank an Besim Karadeniz!

Autorenschaft

Anders als im Blog wird der Autor bei Wiki-Beiträgen nicht gekennzeichnet (nur in der Versionsgeschichte), da ermutigt werden soll, bestehende Artikel zu berichtigen, zu erweitern und nach einigen Jahren auch zu modernisieren.

Die Vorlage:Autorbox wurde nur für die Übertragung der Selfhtml-aktuell-Artikel, für die ein anderes Lizenzmodell gilt, geschaffen und sollte nicht mehr verwendet werden.

Sprache und Rechtschreibung

Die Rechtschreibung im SELFHTML-Wiki orientiert sich am Regelwerk „Deutsche Rechtschreibung. Regeln und Wörterverzeichnis“ in der jeweils aktuellen Fassung, die das Institut für Deutsche Sprache (IDS) in Mannheim veröffentlicht.

Hinweis:
Bei der Korrektur vorhandener Texte sollte nachsichtig vorgegangen werden. Insbesondere bei Zweifelsfällen sollte die Meinung des Autors ausschlaggebend sein.

Sprachkonsistenz und Terminologie

In einem Wiki mit einer Vielzahl an Autoren bleibt es nicht aus, dass unterschiedliche Sprachstile entstehen. Jedoch sollte jeder Autor versuchen, sich am Stil von SELFHTML zu orientieren. Nicht, weil SELFHTML etwa der Stein der Weisen im Sprachstil sein will. Nein, einfach weil es dem Leser leichter fällt, einen einheitlichen Stil zu lesen.

Die Terminologie sollte daher möglichst einheitlich sein. Wenn z. B. hier von HTTP-Server und da von Web-Server die Rede ist, sollte dies vereinheitlicht werden. Das gilt auch für uneinheitliche Schreibweisen wie Web-Server und Webserver. Zur Orientierung hilft auch ein Blick ins Glossar.

Stil

Das Motto "Die Energie des Verstehens" sollte in allen Seiten des SELFHTML-Raums spürbar sein. Verständlichkeit und Transparenz sind höchstes Gebot. Kurze Sätze sind tendenziell besser als lange Sätze. Allerdings ist auch kein Telegrammstil und schon gar nicht das in vielen Online-Kommunikationen übliche Halbsatzgestammel erwünscht. Generell kann man jeden Text auf seine Qualität hin überprüfen, indem man für jeden darin enthaltenen Satz versucht, explizit zu begründen, warum der Satz da steht.

Komplexe Sachverhalte verlangen allerdings manchmal auch, sich dem Ziel des Verständlichmachens in mehreren Ansätzen zu nähern. Denn die angestrebten Aha-Effekte stellen sich nicht bei jedem Leser an der gleichen Stelle ein. In entsprechenden Textpassagen sollten sich zwei, drei oder mehrere Sätze bewusst ergänzen, indem sie den Sachverhalt aus verschiedenen Perspektiven erklären, z. B. einmal durch eine nüchterne Definition, dann durch einen Vergleich, dann durch eine Einordnung in Umgebungswissen, garniert durch Links dorthin.

An geeigneten Stellen - z. B. bei zusätzlichen Kommentaren oder in Beispielen - sind darüber hinaus durchaus Ironie und Esprit erlaubt und sogar erwünscht. Denn solche Bonbons für wache Geister lockern den Gesamttext auf und sorgen für einen intellektuellen Mehrwert, für den SELFHTML ebenfalls bekannt ist.

Du oder Sie?

Im Deutschen werden die Leser im SELFHTML-Raum in der Sie-Form angeredet. Diese Form wird von den meisten Lesern auch heute noch als unaufdringlicher und seriöser empfunden als die Du-Form.


Quellen

  1. Wikipedia: Tutorial
  2. Dieser Artikel ist eine Neufassung eines seit 2010 bestehenden Wiki-Artikels von beatovich und ThomasJS. Damals ging es um allgemeine Regeln, da die jetzige Wiki-Struktur noch nicht vorhanden war.
  3. Wikipedia: Didaktische Reduktion

Siehe auch