Frage zum Wiki-Artikel „Grundlagen der Programmierung“

[Camping_RIDER]

Aloha ;)

Danke für deine Ausführungen. Ich bin fast vollständig bei dir.

Ich finde auch und hab das schon mehrfach erwähnt, dass (mich eingeschlossen) viel mehr verlinkt werden sollte. Das ist das WWW! Nehmen wir das Beispiel von oben: Man kann grundsätzlich auch gerne DOM-Methoden verwenden. Da braucht es auch keine weitere Erklärung zu. Ein einfacher Link zu einem DOM-Tutorial ist ausreichend.

Jein. Bei einem Artikel stimme ich dir völlig zu. Bei einem (Anfänger-)Tutorial ist Verlinkung mit Vorsicht zu benutzen - imho sollte in einem Tutorial nur das verlinkt werden, was als gegeben vorausgesetzt wird, als Referenz zum Nochmal-nachlesen. Konzepte, die nach eingehender Überlegung für mindestens einen gewissen Teil der Leser als „noch nicht gelernt“ oder „neu“ einzustufen sind, sollten nicht im Lauf des Tutorials verlinkt werden. Grund ist der, dass man in einem Tutorial den Leser mitnehmen möchte und eine Ablenkung zwischendrin nur dann sinnvoll ist, wenn sie einem „schnell nachlesen“ gleichkommt. Sobald eine Verlinkung geeignet ist, einem Leser Konzentration abzuverlangen, verliert er den Fokus auf das Tutorial und zäumt dann vielleicht tatsächlich das Pferd von hinten auf. Hier ist in Tutorials mMn Vorsicht und Augenmaß geboten. Viele Verlinkungen sind in Tutorials entweder am Anfang („Vorwissen, das zum Verständnis des Tutorials vorausgesetzt wird: …“) oder am Ende („Wenn Sie mehr über xyz erfahren sollen, lesen sie hier“) angebrachter als im Fließtext, einfach aufgrund didaktischer Gesichtspunkte.

Dass viel mehr Verlinkungen stattfinden sollten, damit hast du natürlich vollkommen Recht (nur eben nicht zwangsläufig im Verlauf der Tutorials).

Außerdem denke ich auch, dass die Artikel oft zu lang werden, weil wir alles an Ort und Stelle nochmal erklären wollen. Außerdem haben wir viel zu viele „Beachten Sie“, Beschreibungen von Ausnahmen oder „Wenn-Dann-Sonst“-Konstruktionen. Ich denke vor allem – aber nicht nur – bei den Einsteiger-Tutorials müssen wir uns davon verabschieden, jede denkbare Möglichkeit für jeden potenziellen Anwendungsfall und jede Fehlermöglichkeit beschreiben zu wollen. Das werden wir erstens nie schaffen und zweitens sind die Artikel nachher so kompliziert, dass sie zwar völlig richtig sind, aber niemand mehr irgendwas versteht.

Richtig. Die Devise sollte dann aber in die Richtung gehen, dass man gerade bei Anfängertutorials scharfe inhaltliche Grenzen ziehen sollte und lieber zwei Tutorials als ein langes produzieren sollte. Die dürfen dann ja auch gerne aufeinander als „Vorwissen“ bzw. „Weiterführendes“ verweisen.

Grüße,

RIDER