Pair Programming

Auftrag

Implementiert das Spiel Knobelscheit gemäss untenstehender Aufgabenstellung basierend auf dem Repository m426-2026/knobelscheit.

  • Vereinbare einen Termin für eine gemeinsame Videokonferenz mit deinem Partner von ca. einer Stunde.
    • Stellt sicher, dass alle Beteiligten Zugriff auf den gleichen Fork vom Originalrepository haben.
  • Bearbeitet die untenstehende Aufgabenstellung gemeinsam gemäss TDD- und Pair-Programming-Vorgehen.
    • Zeichnet die Videobesprechung auf (Audio und Video).
    • Alle Beteiligten sollen mindestens einmal die Rolle des Drivers und des Navigators einnehmen. Der Driver teilt dabei jeweils seinen Bildschirm.
    • Für jedes Gruppenmitglied soll eine Driver-Sequenz von ca. 2-3 Minuten herausgesucht und dazu die entsprechende Zeitangabe notiert werden, z.B. 15:13-17:54.
    • Erstellt regelmässige Commits, etwa dann, wenn ein Test zum Durchlaufen gebracht worden ist.
  • Reicht das Ergebnis als Pull Request ein.
  • Reflektiere die Pair Programming Session selbständig auf ca. einer halben A4-Seite (ca. 200-250 Wörter). Orientiere dich dabei an den folgenden Leitfragen:
    1. Was ist mir in der Rolle als Driver und Navigator gut gelungen; was hat mir Mühe bereitet?
    2. Was würde ich das nächste mal wieder gleich; und was anders machen?
    3. Inwiefern werde ich Pair Programming in Zukunft betreiben?

Bedingungen

  • Es werden keine KI-Tools eingesetzt; weder für die Programmierung noch für die Reflexion.
    • Zuwiderhandlung: 0 Punkte für die jeweilige Kategorie (Reflexion bzw. Ergebnis & Methodik)
  • Es wird erst API-Dokumentation durch den Navigator konsultiert, wenn keine der Beteiligten mehr weiterhelfen können.
  • Es wird kein Code eins zu eins aus externen Quellen übernommen, sondern nachgeschrieben.

Abgabe

  • Im Abgabeordner mit dem Gruppennamen werden folgende Dateien abgelegt:
    1. Aufzeichnung.mp4: Das Video der Aufzeichnung
    2. Zeitangaben.txt: Die Zeitangaben der ausgewählten Sequenzen nach folgendem Format:
      • [Vorname1] [Nachname1]: mm:ss-mm:ss
      • [Vorname2] [Nachname2]: mm:ss-mm:ss
    3. Reflexion-[Vorname]-[Nachname].docx: Die Reflexion jedes Gruppenmitglieds
    4. Pull-Request.txt: Link auf Pull Request

Bewertung (Rubrik)

  • Ergebnis
    1. nichts abgeschlossen
    2. Würfel inkl. Unittest umgesetzt
    3. Knobelscheit inkl. Unittest umgesetzt
    4. Spiellogik umgesetzt
  • Methodik (Pair Programming, Test-Driven Development)
    1. nicht erkennbar
    2. ansatzweise erkennbar
    3. teilweise eingehalten
    4. konsequent eingehalten
  • Aufzeichnung (Bild und Sprache)
    1. nicht vorhanden
    2. hinterlassen schlechten Eindruck
    3. hinterlassen mässigen Eindruck
    4. hinterlassen professionellen Eindruck
  • Reflexion
    1. nicht vorhanden
    2. oberflächlich, allgemein
    3. Reflexionsfragen teilweise behandelt
    4. Reflexionsfragen vollständig behandelt

Pro Kategorie sind max. drei Punkte erreichbar. (Maximalpunktzahl: $4 \times 3 = 12$) Es können auch halbe Punkte vergeben werden.

Die Reflexion wird einzeln bewertet, die anderen Kategorien gemeinsam. (Bei groben Leistungsunterschieden kann die Benotung einzeln erfolgen.)

Ist der angegebene Ausschnitt zu wenig aussagekräftig, wird zur Bewertung der Rest des Videos beigezogen.

Aufgabenstellung: Knobelscheit

Implementiert das Spiel Knobelscheit als Kommandozeilenanwendung. Dieses ist im Folgenden beispielhaft erklärt:

Spielverlauf

Die Ausgangslage: die Zahlen von eins bis neun sind in der Ursprungsposition:

1 1

Die erste Zahl kann umgeklappt werden:

2 2

Da die Zahl, welche der Augensumme entspricht, bereits umgedreht worden ist, werden zwei Zahlen umgedreht, die ebenfalls die Augensumme ergeben:

3 3

Eine weitere Zahl kann umgeklappt werden:

4 4

Die Augenzahlen der beiden Würfeln entsprechen den beiden umgeklappten Zahlen:

5 5

Abermals wird die gleiche Zahl gewürfelt. Sie lässt sich erneut durch eine andere Kombination abbilden:

6 6

Leider geht es dieses Mal nicht auf:

7 7

Im zweiten Versuch klappt es doch:

8 8

Das Spiel ist nach sieben Würfen beendet:

Umsetzung

  • Benutzerinteraktion
    • Der Benutzer sieht bei jedem Spielzug, welche Zahlen bereits umgeklappt worden sind, und welche noch nicht.
    • Bei jeder Runde wird mit zwei Würfeln mit den Zahlenwerten von 1-6 gewürfelt. Der Benutzer gibt an, welche Zahl(en) er umdrehen möchte. Die Zahlen werden nur umgedreht, wenn ihre Summe der erwürfelten Augensumme entspricht.
    • Das Spiel endet, wenn alle Zahlen umgedreht worden sind.
    • Am Schluss des Spiels soll der Benutzer erfahren, wie oft er würfeln musste.
  • Technisch
    • Das Spiel soll auf der Kommandozeile gespielt werden.
    • Es dürfen ausser der vorkonfigurierten assert-Library für Unittests keinerlei Dependencies aufgenommen werden.
    • Die interaktive Spiellogik soll von der Implementierung des Spielmodells (das Knobelscheit mit den 9 Zahlen) auf Quellcode-Ebene getrennt sein.
  • Vorgehen
    1. Würfel: Schreibt Unittests und Logik für das Würfeln gemäss TDD-Vorgehen.
    2. Knobelscheit: Schreibt Unittests und Logik für das Knobelscheit gemäss TDD-Vorgehen.
    3. Spiellogik: Schreibt die Spiellogik und testet sie dazu manuell.

Fragen & Antworten

  • Video: Müssen unsere Gesichter im Video zu sehen sein oder reicht der Ton und die Bildschirmaufnahme vom Code?
    • Die Gesichter müssen nicht sichtbar sein. Der Gesichtsausdruck kann aber für den Partner hilfreich sein, weswegen ich empfehle, die Kamera einzuschalten. Auf die Bewertung hat dies aber keinen direkten Einfluss.
  • Dauer: Wie lange soll das gesamte Video ungefähr sein?
    • Die Videoaufzeichnung soll die gesamte Besprechung umfassen und sollte ca. 30-60 Minuten lange sein.
  • Überlänge: Unser Video ist wesentlich länger geworden, als eine Stunde. Ist das ein Problem?
    • Das ist völlig in Ordnung; ihr habt mehr Einsatz gezeigt, als erwartet worden ist.
  • Tests: Wie viele Unittests müssen wir mindestens schreiben, damit die TDD-Methode als erfüllt gilt?
    • Die nicht-interaktive Programmlogik sollte eine relevante Testabdeckung haben; 80% sollten locker drin liegen (80/20-Regel: 20% vom Testcode sollte 80% vom Produktivcode abdecken können).
  • Spiellogik: Ist es korrekt, dass wir für die interaktive Eingabe keine Unittests schreiben müssen?
    • Korrekt; das könnt ihr manuell testen. Evtl. ist es aber sinnvoll, gewisse Teile des interaktiven Codes in die Library auszulagern und auch zu testen. Das ist aber optional.
  • Sprache: Muss das ganze Pairprogramming auf Hochdeutsch gemacht werden oder kann auch Schweizerdeutsch benutzt werden?
    • Ihr könnt das Video auf Schweizerdeutsch oder Hochdeutsch machen; so wie es für euch am natürlichsten ist.