Benutzer:HirnSpuk/Werkstatt00

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen

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).

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.[Erläuterung 1]

Voraussetzungen für die Tutorialstruktur

[Bearbeiten | Quelltext bearbeiten]
  1. Einfügen neuer Seiten geschieht durch…?? (Anm.: Hier sollte noch die Struktur und Funktionsweise kurz erklärt oder zumindestens verwiesen werden)
  2. Die Abarbeitung einer Reihenfolge eines Stranges ist ein kann, kein muss
  3. Die Reihenfolge eines Stranges soll einen Entwicklungsgang vorzeichnen
  4. Beschreibungen von nachrangigen Aufgaben oder Tätigkeiten sollen ans Ende des Stranges gestellt werden

Gestaltung eines Strangs

[Bearbeiten | Quelltext bearbeiten]
  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[Erläuterung 5]

Gestaltung einer Seite

[Bearbeiten | Quelltext bearbeiten]
  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[Erläuterung 6][Erläuterung 7][Erläuterung 8]
  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[Erläuterung 8]
  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)[Erläuterung 9]
  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[Erläuterung 10][Erläuterung 11]
  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?)[Erläuterung 12][Erläuterung 13][Erläuterung 14]
    • Nicht zu verwenden sind deshalb:
      • „Auf der vorigen Seite hast du gesehen, wie …“ [Erläuterung 15]
      • „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

[Bearbeiten | Quelltext bearbeiten]
  • 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.[Erläuterung 16]
  1. Das steht in Wikipedia:Tour für Leser (Anm.: Ist das nicht genau das, was ich auf der Diskussionsseite sagte, als ich sagte Stadium 1 ist wohl nicht so wichtig und ich von PC „schärfsten Widerspruch“ erfahren habe?)
  2. In den 2000ern gab es nur einen Strang, die Neukonzeption (vgl. Wikipedia Diskussion:Starthilfe/Neu) sieht mehrere Stränge vor.
  3. Dies wird auch Branching Tutorial genannt
  4. Das komplexe Gesamtziel soll in handhabbare, überschaubare Einzelseiten aufgespalten werden
  5. Vgl. (Stand 2017): Wikipedia:Tutorial/6 und Wikipedia:Tour für Leser/6
  6. Eine Einheit bildet damit ein Thema aus einer Hilfe- oder Projektseite in vereinfachter Form ab
  7. Sonder- und Spezialfälle werden auf der verlinkten Hilfeseite erläutert (vgl. Link zu einer Metaseite)
  8. a b Detailbeschreibungen können schnell zu Inkonsistenzen zwischen Tutorial- und Meta-Seiten führen; auch detaillierte Software-Fragen (Layout, Screenshots) veralten sehr schnell, Pflegebedarf wird nicht bemerkt und der Seiteninhalt wird ganz falsch
  9. Im Zweifel auf weitere Seiten ausweichen, die im Strang übersprungen werden könnten
  10. So wird der Themenbereich im Metabereich verankert und kann beliebig vertieft und in Zusammenhang gesetzt werden
  11. Die normalen Meta- und Hilfe-Seiten sind zuständig für die vollständige Behandlung, die Hintergrundinformationen, den geschichtlichen Abriss und Diskussionsprozesse; die Stränge sollen das nicht leisten
  12. Es mag sein, dass aus der Abfolge des Strangs Seiten entfernt werden, eingefügt werden oder die Reihenfolge sich ändert.
  13. Auch ungenutzte Einheiten können im Pool aller Einheiten dümpeln
  14. Ob eine Einzelseite momentan in einen oder womöglich mehrere Stränge eingebunden ist, oder in keinen, hängt nur von der Gesamtkonfiguration ab und kann sich dort permanent ändern. Wird dort etwas geändert, kann niemand ahnen, dass es auf irgendeiner Einzelseite Anpassungsbedarf gibt.
  15. Einzelseiten, die kein eigenes Thema behandeln, sondern nur einen Strang eröffnen oder schließen, sind davon naturgemäß nicht betroffen.
  16. Das betrifft alle individuellen konkreten Einzelaktivitäten: „Ich wollte mein Benutzerkonto ‚Schweinigel‘ anlegen, aber das klappte nicht. Warum?“

Unverständliches

[Bearbeiten | Quelltext bearbeiten]
  • 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.