Fertige Aufgaben einreichen und angerechnet bekommen

Arbeitsschritte

Übliches Abgabeformat

In der Zeiterfassungsaufgabe haben wir uns mit der Commit-Nachricht beschäftigt, hier soll es um den Commit-Inhalt gehen.

Grundsätzlich liegt im Hauptverzeichnis Ihres Repos mindestens eine Datei pro Aufgabe, manchmal auch ein Verzeichnis mit mehreren Dateien, die zu derselben Aufgabe gehören.

Angenommen, es gibt eine (dort aber tatsächlich gar nicht geforderte) Markdown-Datei für die Aufgabe "Zeiterfassung" sowie zwei (hier ebenfalls tatsächlich gar nicht geforderte) Dateien Script.py und Screenshot.png für die aktuelle Aufgabe "Einreichungen", dann sieht Ihr Arbeitsverzeichnis vielleicht so aus:

1
2
3
4
5
6

Programmierpraktikum
├─README.md
├─Zeiterfassung.md
└─Einreichungen
  ├─Script.py
  └─Screenshot.png

Kurz gesagt: Abgabedateien haben immer den Aufgabennamen als Basisname (die Suffixe wechseln) oder sie liegen in einem Verzeichnis, das wie die Aufgabe heißt.

Genauer gesagt, ist es so:

Datei-Basisnamen und -Namensendungen

Wir verwenden im gesamten Programmierpraktikum folgende Dateinamens-Konventionen (bei einer Datei namens hallo.xy wird hallo Basisname genannt und xy heißt Endung oder Suffix):

• Die Datei-Basisnamen auf der oberen Verzeichnisebene heißen immer wie die jeweilige Aufgabe.
• Verzeichnisname auf der oberen Verzeichnisebene ebenfalls.
• Ein Verzeichnisname ist immer ohne Endung.
• Die Dateiendungen in Verzeichnissen können alles Mögliche sein, je nach Aufgabe.
• Die Dateiendungen auf der oberen Verzeichnisebene sind wie folgt:
  • Markdowndateien heißen *.md
  • Python-Quelltextdateien heißen *.py
  • Shellskripte heißen *.sh
  • Entsprechend auch für andere Programmiersprachen.
  • Kommandoprotokolldateien heißen *.txt

Was gehört in welche Dateien?

Manchmal ist verbal beschrieben, was Sie in welchen Dateien abliefern sollen. Manchmal (aber nur ab Schwierigkeitsgrad mittel) müssen Sie es teilweise selbst herausfinden.

Meistens ergibt es sich jedoch aus folgender Konvention:

• Wenn Sie in der Anleitung Markierungen sehen wie 1, 2, 3, dann ist als Abgabe dazu eine Markdown-Datei gefragt und Sie sollten darin die gleichen Markierungen (nur ohne Farbe) für die zugehörigen Antworten verwenden.
• Wenn Sie in der Anleitung Markierungen sehen wie 1, 2, 3, dann ist als Abgabe dazu ein Kommandoprotokoll gefragt.
• Wenn Sie in der Anleitung Markierungen sehen wie 1, 2, 3, dann gehört das zugehörige Arbeitsergebnis in Quellcodedateien.
• F steht für Frage, K für Kommando und A für Anforderung.

Commits nachholen

Prüfen Sie ihre Commits zu den vorherigen Aufgaben.

• Benennen Sie falsch benannte Dateien um und checken Sie sie (ohne Zeiterfassungs-Eintrag) erneut ein.
• Holen Sie ggf. fehlende Commits nach.
• Falls Zeiterfassungs-Einträge fehlen, holen Sie diese mit geschätzten Zeiten ebenfalls nach.

Abgaben (Einreichungen) machen

Nachdem Sie einige Commits zu vorherigen Aufgaben erstellt haben, können Sie in Ihrem Arbeitsverzeichnis folgenden Befehl ausführen:

1

sedrila student --submission

Sie bekommen dann eine Liste mit Aufgaben, zu denen Sie Commits angelegt haben. Sie können darin auswählen (TODO_1 Wie?), welche Aufgaben zur Kontrolle vorgelegt werden sollen. Daraus wird eine Datei submission.yaml im richigen Format erzeugt. Abschließend zeigt das Kommando an, wie es weitergeht: Email an eine Tutor_in.

Da hier nichts weiter zu tun ist, Sie aber trotzdem Zeit gutgeschrieben haben wollen, können Sie ausnahmsweise einen Zeiterfassungscommit ohne Inhalt machen. Hierfür verwendet man git commit --allow-empty -m"...".

Vergessen Sie nicht, Ihren Stand mittels git push verfügbar zu machen!