Kurzanleitung für das DVA-Praktikum (INF) im Sommer 2024

H. Högl, 2024-03-19 

Liebe Studentinnen und Studenten,

für den ersten Termin am kommenden Donnerstag den 21.3. bitte ich Sie folgende
Vorbereitungen zu erledigen (das entspricht der "Vorbereitungsaufgabe"):


1. Die folgende Website zur Veranstaltung durchlesen (diese Nachricht hier ist
   eine Zusammenfassung des etwas längeren Textes):

   https://hhoegl.informatik.hs-augsburg.de/hhwiki/DVAINF_Praktikum


2. Die Teams sollten sich untereinander schon mal kennenlernen und
   Zuständigkeiten klären. Die Teams finden Sie auf Moodle

   https://moodle.hs-augsburg.de/course/view.php?id=8018

   Jedes Team sollte eine Teamsprecherin oder einen Teamsprecher benennen.
   Wer noch in keinem Team ist, sollte einem beitreten. 


3. Je nachdem, wie gut sie sich schon mit Git auskennen, empfehle ich:

   Einloggen auf Gitlab (nur über VPN!): https://gitlab.informatik.hs-augsburg.de
   Beispiel-Repository anlegen, klonen, commit, push, pull, ... Das sollen alle
   Teammitglieder mit einem Beispiel-Repository ihrer Wahl testen, so dass Sie
   sich an die gemeinsame Arbeit in Gitlab gewöhnen. 

   Zum Anfreunden mit Git(lab) empfehle ich folgende Literatur:

   - Pro Git Buch (frei) https://git-scm.com/book/de/v2
   - Gitlab Doku https://docs.gitlab.com/ce/

   Sie sollten ihren ssh Schlüssel in gitlab ablegen, damit Sie nicht bei
   jedem Gitlab Zugriff über HTTP ihr RZ Passwort eingeben müssen. 
   Siehe die Beschreibung unter https://docs.gitlab.com/ee/user/ssh.html.
   Damit können Sie dann über die "ssh" Methode zugreifen.
   
   Hier ist eine Kurzübersicht der Git Kommandos:
   https://education.github.com/git-cheat-sheet-education.pdf


4. Den Demo-Bericht mit Git clonen und verstehen, wie die Struktur ist und 
   wie man den Text nach HTML übersetzt (make html).

   HTML: https://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht

   Gitlab: https://gitlab.informatik.hs-augsburg.de/hhoegl/sphinxbericht

   Achten Sie darauf, dass Sie nur die Quelltextdateien klonen, nicht die 
   Build Artefakte (z.B. das HTML Ausgabeverzeichnis). 


5. Den Demo-Bericht anpassen auf die eigene Gruppe und in das Team Repository
   hochladen.  Die Repositories finden sie unter:

   https://gitlab.informatik.hs-augsburg.de/dva/berichte-2024

   Die Namen sind "01", "02", ... "51", "52", ...  In jedem Team gibt es einen
   Git Maintainer, der vom Betreuer eingetragen wird, sobald die Bildung
   der Teams abgeschlossen ist.
   
   Der Git Maintainer bekommt von Git eine Email. Der Maintainer muss daraufhin
   seine TeamkollegInnen eintragen.  Nur die Rolle "Maintainer" darf direkt in
   das Repo Änderungen pushen.  Es können also gerne alle im Team als 
   Maintainer eingetragen werden.

   Ausserdem muss die HTML Ausgabe des Berichts auf das RZ WWW Verzeichnis 
   des Teamsprechers kopiert werden.  Wie das geht steht im längeren Text
   unter Punkt 1.


6. Sich im Team auf einen ersten Versuch einigen, der dann ab 21.3. zwei Wochen
   bis 4.4. bearbeitet wird.

Sollte es irgendwo Fragen oder Schwierigkeiten geben, dann bitte ich Sie in
das Forum dieses Moodle Kurses zu schreiben, da diese Fragen sicher auch
für andere interessant sind. Die Betreuer werden dann anworten, gerne
können aber auch Studienkolleginnen und Kollegen antworten.

Viele Grüsse,

Ihre Betreuer