Hallo Janosch,
Man sollte sich vor der Erstellung eines Tutorials klar machen, was gelehrt werden soll und dann genau diesen einen Aspekt ausführlich behandeln. Und sonst nichts.
Sonst muss ja jedes Tutorial alles erklären.
Genau das! Lernziele festlegen! Didaktische Reduktion überall anders!
... sagt der Pädagoge. ;-)
Ein Tutorial soll grundsätzlich ein barrierefreies Ergebnis liefern, aber nicht unbedingt explizit erläutern, dass das gemacht wird, und warum das so gemacht wird - außer eben das gehört explizit zu den Lernzielen des Tutorials.
Das ist aber genau die Lehr- und Lernmethode, die bei mir regelmäßig Frust erzeugt, weil Fragen offen bleiben. Das war schon zur Schulzeit so. Für meine Lernstrategie ist es wichtig, dass ein Tutorial die bewusst weggelassenen Inhalte zumindest benennt und weiterführende Quellen für Interessierte angibt.
Besonders elegant ist es dann, am Ende des Tutorials darauf hinzuweisen: Und wenn sie sich jetzt fragen, warum wir [xyz] so gemacht haben und nicht anders, dann lesen sie hier...
Ich finde das nicht "besonders elegant", sondern eine elementare Forderung.
TL;DR: Alles richtig machen, ja! Alles erläutern, nein.
Einverstanden. Aber dann zumindest zeigen, wo's weitergeht.
Schönes Wochenende,
Martin