Benutzer:HirnSpuk/Werkstatt00

Aufgrund von Benutzer Diskussion:HirnSpuk Gespräch mit Lómelinde, von Wikipedia:Tutorial/!Guidelines;

• was hab ich gemacht: gefühlten Befehlston entschärft, umstrukturiert, Erklärungen ausgelagert, Anmerkungen eingefügt
• warum hab ich das nicht direkt auf der Betroffenen Seite gemacht: Angst, keine Lust mutig zu sein

---

Leitlinien für die Erstellung von Seiten des [[../]]s (ab Winter 2017/18).

Einleitung

Die Grund-Methodik eines Tutorials ist seit bald einem halben Jahrhundert (insbesondere im US-amerikanischen Bereich) ständige Praxis; es gibt regalmeterweise Anleitungen, wie gute Tutorials zu strukturieren, zu portionieren und inhaltlich mit Text und Grafik zu füllen sind (auch für „Tutorial“ hat sich kein deutschsprachiger Begriff etabliert) (Anm: Hier wäre ein Literaturhinweis ganz nett, wenns davon meterweise gibt, kann eine Angabe ja nicht so schwierig sein). Die Bearbeiter des allerersten Wikipedia-Tutorials seit 2004 hatten diese offenbar gekannt und das im Rahmen der seinerzeitigen Möglichkeiten auch umgesetzt. Siehe auch Programmierte Unterweisung und Programmierter Unterricht – dort stünden allerdings am Ende jeder Einheit Aufgaben zur Selbstkontrolle, und/oder es werden Aufgaben zum Ausprobieren gestellt. Das geht für uns etwas zu weit; wir sind nicht in der Position von Lehrern, die Hausaufgaben aufdrücken, um gleich ein „Benutzerkonto anlegen“ oder einen „neuen Artikel auf eigener Benutzerseite schreiben“ produktiv umzusetzen.

• Das Tutorial soll die Informationen und Fähigkeiten, die erforderlich sind, um in den ersten Tagen und Wochen sinnvoll als Bearbeiter aktiv werden zu können, vermitteln.
• Diese Vermittlung soll bis hin zur Anlage des ersten eigenen Artikels, zumindest im Benutzernamensraum, reichen.
• An den geeigneten Stellen sollen Anreize und Möglichkeiten zur Vertiefung und zum Ausbau angeboten werden.
• Vorausgesetzt wird die Kenntnis einer Wikipedia allgemein, als Leser; was eine Wikipedia ist und was sie nicht ist.

Voraussetzungen für die Tutorialstruktur

• Das WP:Tutorial hat mehrere Stränge (auch: Trail, Pfad)
• Alle Seiten/Einheiten der Tutorialstränge finden sich hier:…
• Jeder Strang behandelt eine unabhängige thematische Gruppe und löst eine komplexe Aufgabe.
• Die Anzeige der Stränge wird über ein Modul und die Benennung der Seiten gesteuert
• Die Stränge decken bestimmte Themenbereiche ab und sollen in einer Reihenfolge präsentiert werden

Leitlinien

Gestaltung eines Strangs

1. eine logische sich teils zwangsläufig ergebende Reihenfolge berücksichtigen, Kenntnisse der vorhergehenden Seiten im Strang können vorausgesetzt werden
2. die erste Seite eines Stranges soll immer aus einer Inhaltsangabe und der Motivation bestehen, aber keine inhaltlichen Details nennen
3. Eine Auflistung der Strang-Seiten darf nicht erfolgen, da sich diese dynamisch ändern können und in der Navigationsbox angezeigt werden
4. Die letzte Seite soll analog dazu eine Zusammenfassung mit Anwendungsbeispielen und Vertiefungshinweisen sein

Gestaltung einer Seite

1. Eine Einzelseite heißt auch Lesson oder Einheit
2. direkt zum Punkt kommen, Neugierde über verlinkte, klickbare Schlagwörter wecken (verlinkt auf meta- oder enzyklopädische Bereiche)
3. Eine Einzelseite soll genau ein abgeschlossenens Unterthema behandeln
4. Die beschriebene Aufgabe soll mit der Einheit alleine (für Einsteiger) lösbar sein(Anm.: Widerspricht das nicht dem „vorhergehende Strangseiten können vorausgesetzt werden?“ Daher habe ich das folgende ergänzt), im Zweifel ist darauf hinzuweisen, dass vorhergehende Seiten eines Stranges hilfreich sind.
5. Die Einheit sollte recht allgemein gehalten werden, überflüssige Details sollen weggelassen werden
6. Eine Einheit sollte unabhängig von einem Strang funktionieren
7. Der Umfang sollte so kurz wie möglich und so umfangreich wie nötig sein, maximal eine – im Ausnahmefall zwei – Desktop-Seite(n) kann als Maß gelten (hierbei an unterschiedliche Bildschirmauflösungen und Mobilgeräte denken)
8. Auf Überschriften und Abschnitte sollte verzichtet werden, das ist auch auf einer kurzen Seite nicht unbedingt nötig
9. Es sollen Beispiele gezeigt werden (z. B. ein ausgefülltes Formular)
10. Bilder, Grafiken und Erklärvideos sollen rechts angeordnet werden
11. Am Schluss jeder Einheit soll mindestens ein Link zu einer Hifle- oder Projektseite stehen
12. Die Einheiten sollen aufgrund des automatischen Stranges keine Bezüge untereinander aufweisen (Anm.: wie oben, widerspricht das nicht der Idee, dass vorangegangene Einheiten eines Stranges als bekannt vorausgesetzt werden?)
    • Nicht zu verwenden sind deshalb:
      • „Auf der vorigen Seite hast du gesehen, wie …“
      • „Wie man dann dies und das macht, wird auf der übernächsten Seite erläutert.“
      • Selbst geschriebene Auflistung aller Themen auf der ersten Seite des Strangs; das macht allein die Software entsprechend der aktuellen Konfiguration (s. o. #Gestaltung eines Strangs)
13. Es sollen zeitgemäße Beschreibungen in den Einheiten verwendet werden
    • Über 50 % der Bearbeitungen erfolgen von Mobilgeräten aus
    • IP und neu Angemeldete werden auf den VisualEditor geleitet
    • Es sollte nicht auf den Arbeitsstil von vor zehn Jahren mit Desktop und Quelltext fokussiert werden

Diskussionsseiten der Einheiten

• Alle Diskussionsseiten zu allen Einzelseiten, Dummies, Strängen sind auf eine einzige zentrale WD:TUT weiterzuleiten. (Anm.: Ist das wirklich sinnvoll?), diese kann dann zentral beobachtet werden. (Anm.: Unter der Bedingung ist das sinnvoll, aber was, wenn sich die Fragen und Kommentare zu Einzelseiten auf einer häufen? Risiko ist minimal, daher einfach machen?)
• Anregungen zur Verbesserung irgendeines Tutorial-Textes sollen dort vorgetragen werden.
• Generelle inhaltliche Fragen und Probleme sind hingegen nur auf Wikipedia:Fragen von Neulingen zu klären; dies muss einleitend verdeutlicht werden.

Unverständliches

• In der Regel sind die Kriterien für ein Howto zu erfüllen; jede Tutorial-Seite beschreibt eine Problematik und wie diese zu lösen wäre. Teilweise erfolgt dies durch Bedienung von MediaWiki-Software, teils durch enzyklopädisches Arbeiten.