Informatik · Klasse 10

Ideen für aktives Lernen

Dokumentation und Clean Code

Aktive Methoden wie Code-Analysen und Reflexionsrunden zeigen Schülern sofort, warum Dokumentation und Clean Code mehr sind als Regeln. Durch das eigene Erleben verstehen sie, dass gut strukturierter, lesbarer Code Zeit spart und Fehler reduziert, während reine Kommentare oft nur Symptome verdeckter Probleme sind.

• KMK Bildungsstandards
• KMK: STD.02
• KMK: STD.08

• 20–40 Min.
• Partnerarbeit → Ganze Klasse
• 3 Aktivitäten

Aktivität 01

• Forschungskreis
• 40 Min. · Kleingruppen

Forschungskreis: Code-Detektive

Schüler erhalten zwei Versionen desselben Programms: Eine mit kryptischen Namen und eine in 'Clean Code'. Sie müssen unter Zeitdruck eine Änderung vornehmen und vergleichen, wo es schneller ging.

Warum schreiben wir Code primär für Menschen, nicht für Maschinen?

Moderationstipp

Stellen Sie sicher, dass die anonymisierten Code-Schnipsel für die Peer-Bewertung realistische Fehler enthalten, die die Schüler selbst gemacht haben könnten.

Worauf zu achten ist

Die Schüler erhalten anonymisierte Code-Schnipsel ihrer Mitschüler. Sie sollen auf einer Checkliste bewerten: Sind die Variablennamen aussagekräftig? Sind die Funktionen kurz und fokussiert? Gibt es Kommentare, wo sie nötig sind? Sie geben eine schriftliche Begründung für mindestens eine Verbesserung.

• Analysieren
• Bewerten
• Erschaffen
• Selbststeuerung
• Selbstwahrnehmung

Aktivität 02

• Museumsgang
• 35 Min. · Ganze Klasse

Museumsgang: Die Dokumentations-Wand

Gruppen erstellen Plakate mit Best Practices für Clean Code (z.B. 'Don't repeat yourself'). Sie hängen Beispiele für 'schlechten' und 'guten' Code daneben auf.

Was macht eine gute technische Dokumentation aus?

Moderationstipp

Legen Sie bei der Dokumentations-Wand Wert darauf, dass die Schüler nicht nur Texte sammeln, sondern auch die Struktur und Verständlichkeit der Beispiele diskutieren.

Worauf zu achten ist

Auf einem Zettel notieren die Schüler zwei konkrete Vorteile von Clean Code für die Softwareentwicklung und nennen ein Beispiel für eine gute technische Dokumentation, die sie kennen oder sich vorstellen können.

• Verstehen
• Anwenden
• Analysieren
• Erschaffen
• Beziehungsfähigkeit
• Sozialbewusstsein

Aktivität 03

• Ich-Du-Wir (Denken-Austauschen-Vorstellen)
• 20 Min. · Partnerarbeit

Ich-Du-Wir (Denken-Austauschen-Vorstellen): Kommentare vs. Lesbarer Code

Schüler diskutieren: 'Sollte man jede Zeile kommentieren oder den Code so schreiben, dass er sich selbst erklärt?'. Partner erarbeiten Regeln für sinnvolle Kommentare.

Wie verhindern wir „Spaghetti-Code"?

Moderationstipp

Fordern Sie die Schüler beim Think-Pair-Share auf, konkrete Beispiele aus ihrem eigenen Code zu nennen, um die Diskussion zu veranschaulichen.

Worauf zu achten ist

Diskutieren Sie in Kleingruppen: Warum ist es für einen Anfänger schwieriger, guten Code zu schreiben als nur funktionierenden Code? Welche Rolle spielt die Dokumentation, wenn ein Projekt nach einem Jahr wieder aufgenommen wird?

• Verstehen
• Anwenden
• Analysieren
• Selbstwahrnehmung
• Beziehungsfähigkeit

Einige Hinweise zum Unterrichten dieser Einheit

Lehrer sollten hier als Vorbilder agieren: Zeigen Sie Ihren eigenen Code und erklären Sie, warum Sie bestimmte Entscheidungen getroffen haben. Vermeiden Sie es, Dokumentation als lästige Pflicht zu vermitteln. Stattdessen betonen Sie, dass sie ein Werkzeug ist, das die Zusammenarbeit erleichtert. Nutzen Sie echte Beispiele aus der Praxis, um zu zeigen, wie schlecht dokumentierter Code zu kostspieligen Fehlern führt.

Am Ende dieser Einheit sollen Schüler nicht nur die Regeln von Clean Code kennen, sondern sie bewusst anwenden. Sie analysieren Code anderer, erkennen Mängel und überarbeiten eigene Projekte. Ihr Feedback zeigt, dass sie zwischen oberflächlicher Dokumentation und echter Codequalität unterscheiden können.

---

Vorsicht vor diesen Fehlvorstellungen

• Während der Aktivität 'Code-Detektive' beobachten Sie, dass Schüler glauben, ausführliche Kommentare könnten schlechten Code ausgleichen.

  Nutzen Sie die anonymisierten Code-Schnipsel, um gezielt zu zeigen, wie Kommentare oft nur Verwirrung stiften, wenn der Code selbst unklar ist. Fordern Sie die Schüler auf, den Code umzustrukturieren statt ihn zu kommentieren.

• Während der Aktivität 'Die Dokumentations-Wand' fällt auf, dass Schüler die Dokumentation erst am Ende erstellen wollen.

  Verweisen Sie auf die gesammelten Beispiele an der Wand und fragen Sie: 'Würde dieser Code auch ohne Dokumentation verstanden?' Lassen Sie die Schüler ihre eigenen alten Projekte überprüfen und notieren, welche Teile ohne Dokumentation unverständlich wären.

---

In dieser Übersicht verwendete Methoden

• Forschungskreis
• Museumsgang
• Ich-Du-Wir (Denken-Austauschen-Vorstellen)