AD Teaching Wiki:

Lesen Sie diese Seite bitte vor der Bearbeitung und Abgabe des ersten Übungsblattes sorgfältig und vollständig durch. Die Regeln gelten für alle Übungsblätter dieser Lehrveranstaltung. Unwissenheit darüber schützt nicht vor späteren Konsequenzen.

Regeln für die Programmieraufgaben

1. Programmiersprache Wir empfehlen als Programmiersprache Python. Erstens wird auch in der Vorlesung Python benutzt, zweitens stehen die Vorlagen und Tests für die Programmieraufgaben in Python zur Verfügung und drittens erlaubt die einfache Handhabbarkeit dieser Sprache die Konzentration auf das eigentliche Thema dieser Lehrveranstaltung: Algorithmen und Datenstrukturen. Die Aufgaben können auch in Java oder C++ bearbeitet werden, sie sind dann aber (je nach Aufgabe und Vorkenntnissen deutlich) mehr Arbeit. Für Programmieranfänger raten wir ausdrücklich davon ab! Andere Programmiersprachen als die drei genannten sind nicht gestattet.

2. Abgabe Für die Korrektur maßgeblich ist die letzte Version Ihres Codes in unserem SVN vor dem Abgabetermin. Sie können davor so viele Zwischenversionen (zum Beispiel zu Sicherungszwecken) in unser SVN hochladen, wie Sie möchten. Verspätete Abgaben oder Abgaben per Email werden nicht akzeptiert, fangen Sie also rechtzeitig mit der Bearbeitung an. Für theoretische Aufgaben (spätere Übungsblätter) sollte genau ein PDF abgegeben werden, entweder ein gut lesbarer Scan mit gut lesbarer Handschrift oder ordentlich mit LaTeX gesetzt.

3. Makefile Zu der Abgabe jedes Übungsblattes mit einer Programmieraufgabe gehört ein Makefile (für Python und C++) bzw. eine build.xml (für Java) mit den targets compile, checkstyle, test und clean, wie in Vorlesung 1 erklärt und vorgeführt und im SVN unter public/vorlesung-01/ zur Verfügung gestellt. Unser Continuous Build System (Jenkins) prüft dann automatisch nach jedem Commit, ob diese targets fehlerfrei durchlaufen. Sie können einen solchen Durchlauf auch manuell anstoßen.

4. Hochladen Achten Sie darauf, dass Sie keine unnötigen Dateien hochladen, zum Beispiel .pyc oder .o oder .class Dateien. Zu manchen Übungsblättern gehören (große) Datensätze. Diese dürfen erst recht nicht hochgeladen werden, sonst explodiert das SVN und wenn es ganz schlecht läuft das Universum.

5. Kompilieren Das compile target muss grundsätzlich fehlerfrei durchlaufen, sonst wird Ihr Code nicht korrigiert und es gibt keine Punkte. Grund dafür ist, dass Code, der nicht einmal syntaktisch korrekt ist, sehr schwer zu durchschauen sein kann und dies unzumutbar viel Arbeit für die Tutor:innen wäre. Fragen Sie bei Problemen bitte rechtzeitg im Forum, siehe Punkt 9.

6. Tests Wenn Tests vorgegeben sind, dürfen diese nicht verändert werden. Wird der Inhalt eines Tests geändert, gibt es für diesen Teil des Programms keine Punkte. Ausnahme sind kleinere syntaktische Änderungen aus guten Grund oder wenn der Fehler bei uns liegt. Schlägt ein Test fehl, gibt es für diesen Teil des Programms maximal 50% der Punkte. Sie können unsere Tests gerne um zusätzliche Testfälle erweitern, das ist aber kein Muss.

7. Checkstyle Ihr Code sollte frei von checkstyle Fehler sein. Mit Checkstyle-Fehlern riskieren Sie einen Punktabzug bis zu 10% der Gesamtpunktzahl für eine Programmieraufgabe, bei sehr vielen Fehlern bis zu 20%.

8. Lesbarkeit Schreiben Sie modularen und verständlichen Code. Wenn ein Teil des Codes für sich alleine umfangreich bzw. komplex genug ist oder mehrfach benötigt wird, gehört er in eine eigene Funktion. Jedes Stück Code, dessen Funktionsweise sich nicht unmittelbar durch Lesen des Codes ergibt, sollte erklärt werden. Die Erklärung sollte kurz und aussagekräftig sein. Manchmal ist ein Beispiel nützlicher (und kürzer) als eine abstrakte Erklärung. Für unverständlichen Code riskieren Sie ebenfalls einen Punktabzug von bis zu 20%.

9. Forum Wenn Sie ein Problem bei der Implementierung haben, suchen Sie ein paar Minuten (auf Google oder auch auf dem Forum, da wurden sehr viele Fragen schon mal gestellt) nach dem Fehler. Wenn Sie nicht fündig werden, fragen Sie gerne auf dem Forum, da wird Ihnen in der Regel schnell geholfen. Hier unsere Anleitung für das richtige Fragen auf dem Forum.

10. Zusammenarbeit Sie können gerne zusammen über die Übungsblätter nachdenken, aber der Code bzw. die Lösungen müssen zu 100% selber geschrieben werden. Auch das teilweise Übernehmen von Code, egal ob von einer anderen Person, der Musterlösung aus einer vergangenen Vorlesung oder aus dem Internet, gilt als Täuschungsversuch, mit den entsprechenden Konsequenzen. Wir müssen das so deutlich sagen, weil es in der Vergangenheit immer wieder vorgekommen ist. Man lernt nichts, wenn man Code bzw. Lösungen von anderen übernimmt und es ist unfair gegenüber dem Großteil der Teilnehmer:innen, die sich ehrlich Mühe geben.>

Zur Klarstellung zu Regel 10 (29.06.2021): Wenn Variablennamen abgeändert oder Codezeilen umgestellt werden, macht es das nicht besser, sondern schlimmer (es wurde dann auch noch Energie in die Verschleierung investiert). Konsequenzen gibt es für alle an einer Kopieraktion beteiligten Personen, auch diejenigen, die Ihren Code zur Verfügung gestellt haben. Siehe auch Vorlesung 9, Folien 5 und 6.

Regeln für die theoretischen Aufgaben

1. Für die Abgaben zu den theoretischen Aufgaben gilt Punkt 10 von der Liste oben sinngemäß.

2. Für die Punktevergabe gelten folgende Leitlinien. Für eine sinnvolle Grundidee bzw. einen sinnvollen Ansatz gibt es 40% der Punkte. Für die ordentliche Ausarbeitung gibt es 60% der Punkte.

AD Teaching Wiki: AlgoDatSS2021/Regeln (last edited 2021-06-29 16:24:43 by Hannah Bast)