Kleine Änderung im Tutorials-Tutorial

Und wieder gibts eine kleine Änderung meines [post="tutorials-schreiben" text="Tutorials-Tutorial"]. Heute morgen is mir aufgefallen, dass ich gar nicht erwähnt hab, dass auch bei Grundlagen-Tutorials Aufgaben und Verständnisfragen am Ende eines Kapitels sinnvoll sind. Das hab ich jetzt nachgeholt.

Tutorialschreiber-Checkliste

Ich hab kurzerhand mal mein [post="tutorials-schreiben" text="Tutorials-Tutorial"] ein bisschen erweitert. Die größte Veränderung ist eine Checkliste am Ende, die nochmal das Wichtigste zusammenfasst.

Tutorials schreiben

Download: Tutorials schreiben (Größe: 257.41 KB; bisher 480 mal heruntergeladen)

Überblick

Es ist jetzt mittlerweile fast drei Jahre her, dass ich angefangen habe, Tutorials zu schreiben. Seit dem habe ich einiges gelernt. Insbesondere auch dadurch, dass ich mittlerweile fast schon regelmäßig fremde Tutorials korrekturlese. Dabei sind mir einige Dinge aufgefallen, die ich nun hier zusammenfassen möchte. Auch wenn ich meine eigenen bisherigen Tutorials wieder lese, so fällt mir einiges auf, das ich mittlerweile anders machen würde und bei so mancher Formulierung muss ich heute über meine damaligen Texte schmunzeln. Wer Lust hat, kann ja mal nach der Lektüre dieses Tutorials meine bisherigen Texte nach Fehlern und Verbesserungsmöglichkeiten durchsuchen. Es finden sich da so einige…

Ich kann nicht behaupten, dass ich eine besondere Qualifikation für so ein Tutorial vorweisen kann. Ich habe weder etwas dahingehendes studiert, noch Sekundärliteratur zum Thema gelesen. Das, was ich hier beschreibe, stützt sich ausschließlich auf meine “Erfahrungen” mit eigenen und fremden Tutorials und ich denke, ich hätte den ein oder anderen Fehler nicht begangen, wenn mir jemand gesagt hatte, was man besser nicht macht. Nichtsdestotrotz bleibt es natürlich jedem selbst überlassen, was er von meinen Tipps hält. Kommentare jeglicher Art sind herzlich willkommen.

Dieses Tutorial richtet sich somit an alle, die gerne selbst mal ein Tutorial schreiben möchten. Hauptsächlich geht es hier um Programmier-Tutorials, jedoch gilt vieles von dem hier vorgestellten für jegliche Art Tutorial.
weiter lesen »