Wiki source code of GitLab Erklärungen

Version 81.1 by Pascal Meyer on 2025/08/15 00:24

Hide last authors
Pascal Meyer 12.1 1 {{toc/}}
2
Pascal Meyer 4.2 3 Ab dem Wintersemester 2025/2026 wird die Projektstrukturierung und der [[Scrum>>doc:Main.Scrum.WebHome]]-Prozess in GitLab durchgeführt. Für die wichtigsten, grundlegendsten Funktion gibt es nachfolgend als Einstiegshilfe einige Erklärungen.
Pascal Meyer 1.3 4
5 = Issue/Task-Erstellung in GitLab =
6
Pascal Meyer 6.2 7 Für die Erstellung von Issues (User-Stories) oder Tasks (Aufgaben) wird in der Projektnavigationsleiste der Reiter** "Issues" **angeklickt und nachfolgend die Option **"New issue"** ausgewählt.
Pascal Meyer 4.2 8
Pascal Meyer 34.1 9 [[image:Issue1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 4.2 10
Pascal Meyer 5.2 11 Anschließend öffnet sich ein neues Fenster mit vielen Option. Hierbei kann ein Typ, ein Titel, eine Beschreibung und viele weitere unterschiedlichen Funktionen festgelegt werden.
Pascal Meyer 4.2 12
Pascal Meyer 6.1 13 Als **"Type" **stehen drei Optionen zur Auswahl:
Pascal Meyer 5.2 14
Pascal Meyer 6.1 15 * "Incident" - Ein Zwischenfall/Störung
16 * "Issue" - Im SWP eine User-Story (siehe [[User-Stories>>doc:Main.Scrum.WebHome||anchor="HUserStories"]])
Pascal Meyer 6.2 17 * "Task" - Eine Aufgabe
Pascal Meyer 5.2 18
Pascal Meyer 7.1 19 Im unten gezeigtem Beispiel wird ein Issue gewählt und mit einem Titel (Name der User-Story) und einer Beschreibung (Akzeptanzkriterien) versehen.
Pascal Meyer 6.1 20
Pascal Meyer 8.2 21 Zusätzlich ist es möglich den Status (bspw. "To do", "Done", "In progress" etc), den Bearbeiter (ein oder mehrere Gruppenmitglieder), ein oder mehrere Labels, einen Meilenstein (siehe: ), Schätzungen und viele weitere Funktionen einzustellen. Anschließend werden die Angaben mit dem **"Create issue"** Button bestätigt.
Pascal Meyer 6.1 22
Pascal Meyer 34.1 23 [[image:Issue2.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 11.1 24
25 Es besteht im Anschluss direkt die Option sogenannte **"Child items"** hinzuzufügen. Dies ist besonders sinnvoll wenn die User-Story relativ umfangreich ist und somit besser in kleinere Arbeitspakete (bzw. Aufgaben) zerteilt werden sollte. Hierfür wird der **"Add"**-Button und entweder **"New task"** oder **"Existing task"** ausgewählt. Somit können entweder neue Aufgaben formuliert (wie im kommenden Beispiel) oder bestehende hinzugefügt werden.
Pascal Meyer 7.2 26
Pascal Meyer 34.1 27 [[image:Issue3.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 7.2 28
Pascal Meyer 11.1 29 Hier wurde als Aufgabe das Feld für die Eingabe definiert. Anschließend wurde die Eingabe mit **"Create task"** bestätigt.
30
Pascal Meyer 33.6 31 [[image:Issue4.png||data-xwiki-image-style-border="true"]]
32
Pascal Meyer 11.1 33 Nachdem alle Informationen eingepflegt und ausführlich beschrieben wurden, ist das Issue vorerst fertig.
34
Pascal Meyer 33.6 35 [[image:Issue5.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 13.2 36
Pascal Meyer 52.5 37 == Status bei Issues ==
38
Pascal Meyer 52.6 39 In GitLab werden standardmäßig fünf verschiedene Statusformen angeboten. Diese Optionen sind:
Pascal Meyer 52.5 40
Pascal Meyer 52.6 41 * **To do** (wird bei der Issue Erstellung standardmäßig ausgewählt)
42 * **In progress**
43 * **Done**
44 * **Won't do**
45 * **Duplicate**
46
47 Diese Statusformen werden genutzt um eine Sortierung und/oder Priorisierung der Issues zu ermöglichen. Zusätzlich dienen diese aber auch als Orientierung für das gesamte Projektteam. Somit weiß jedes Gruppenmitglied was erledigt ist und was noch erledigt werden muss.
48
Pascal Meyer 53.2 49 [[image:Issue Status 1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 52.6 50
Pascal Meyer 56.1 51 Zur Status Änderung wird einfach die **"Edit"**-Option betätigt und anschließend öffnet sich ein Optionsmenü. Die gewünschte Option muss nur noch bestätigt werden und der neue Status wird festgelegt.
Pascal Meyer 52.6 52
Pascal Meyer 55.2 53 [[image:Issue Status 2.png||data-xwiki-image-style-border="true"]]
54
55 [[image:Issue Status 3.png||data-xwiki-image-style-border="true"]]
56
Pascal Meyer 56.2 57 == Meilensteine und Epics ==
58
Pascal Meyer 58.2 59 Im Laufe des Softwareprojektes werden eine Menge an Issues erstellt. Damit der Überblick, über die Vielzahl an Issues, nicht verloren geht wird im Softwareprojekt mit Meilensteinen (siehe [[Meilensteine>>doc:Main.Anforderungen Software.WebHome||anchor="HAnforderungen:DievordefiniertenMeilensteine"]]) und Epics gearbeitet. In GitLab werden beide Funktionen mit **"Labels"** umgesetzt. Diese Option ist im Reiter "Manage" und anschließend unter "Labels" vorzufinden.
Pascal Meyer 56.2 60
Pascal Meyer 58.2 61 [[image:Label 1.png||data-xwiki-image-style-border="true"]]
62
Pascal Meyer 60.2 63 [[image:Label 2.png||data-xwiki-image-style-border="true"]]
64
65 [[image:Label 3.png||data-xwiki-image-style-border="true"]]
66
Pascal Meyer 60.3 67 Die Erstellung von Epics sind kongruent zur Erstellung der Meilensteine-Label**. **Zur Veranschaulichung wird das Epic-Label **"Lobby" **erstellt.
Pascal Meyer 60.2 68
Pascal Meyer 63.2 69 [[image:Epic1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 60.3 70
Pascal Meyer 63.2 71 [[image:Epic2.png||data-xwiki-image-style-border="true"]]
72
73 [[image:Epic3.png||data-xwiki-image-style-border="true"]]
74
Pascal Meyer 68.1 75 Bei der Issue-Erstellung/Bearbeitung können die erstellten Labels jetzt mit den neuen/bestehenden Issues verknüpft werden. Dies erfolgt trivial zur Status-Option.
Pascal Meyer 63.2 76
Pascal Meyer 68.1 77 [[image:Issue Label 2.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 63.3 78
Pascal Meyer 68.1 79 [[image:Label 4.png||data-xwiki-image-style-border="true"]]
80
81 [[image:Issue Label 3.png||data-xwiki-image-style-border="true"]]
82
Pascal Meyer 13.2 83 = Product-Backlog =
84
Pascal Meyer 33.6 85 Die erstellten Issues werden automatisch nach der Erstellung dem Product-Backlog (siehe [[Product-Backlog>>doc:Main.Scrum.WebHome||anchor="HProductBacklog"]]) hinzugefügt. Der Product-Backlog ist eine Liste mit allen erstellten und unbearbeiteten Issues. Dieser ist im GitLab unter dem Reiter **"Issue boards" **vorzufinden.
Pascal Meyer 17.1 86
Pascal Meyer 33.6 87 [[image:ProductBacklog1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 17.1 88
Pascal Meyer 33.6 89 [[image:ProductBacklog2.png||data-xwiki-image-style-border="true"]]
90
Pascal Meyer 68.2 91 == Pflege/Priorisierung des Product-Backlogs ==
92
Pascal Meyer 18.2 93 Die Pflege des Product-Backlogs (siehe [[Pflege>>doc:Main.Scrum.WebHome||anchor="HDerNutzeneinesgepflegten2FpriorisiertenProductBacklogs"]]) ist in GitLab sehr einfach durchzuführen. Hierfür werden die Issues einfach per "Drag and Drop" (Ziehen und Ablegen) in die gewünschte Ordnung bzw. Priorisierung gebracht. Im ersten Beispiel war die Reihenfolge der Issues #1,#3,#4,#5,#6,#7 und für das Projekt unsortiert. Nach der Sortierung ist die Reihenfolge der Issues #7,#6,#5,#4,#3,#1 (Sortierung willkürlich gewählt und dient nur zu Anschauungszwecke).
Pascal Meyer 17.1 94
Pascal Meyer 33.5 95 [[image:ProductBacklog3.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 17.1 96
Pascal Meyer 70.2 97 == Erstellung neuer Listen ==
98
Pascal Meyer 78.2 99 In GitLab können die Listen auch genutzt werden um beispielsweise Meilensteine oder Epics darzustellen (siehe [[Meilensteine und Epics>>doc:Main.GitLab.WebHome||anchor="HMeilensteineundEpics"]]). Auch der Status der Issues kann dargestellt werden (siehe [[Status>>doc:Main.GitLab.WebHome||anchor="HStatusbeiIssues"]]). Hierfür wird einfach die **"New list"**-Funktion genutzt.
Pascal Meyer 70.2 100
Pascal Meyer 80.2 101 [[image:Liste1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 78.2 102
103
Pascal Meyer 80.2 104 [[image:Liste2.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 78.2 105
106
Pascal Meyer 80.2 107 [[image:Liste3.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 78.2 108
109
Pascal Meyer 80.2 110 [[image:Liste4.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 78.2 111
Pascal Meyer 80.2 112
113 [[image:Liste5.png||data-xwiki-image-style-border="true"]]
114
115
116 [[image:Liste6.png||data-xwiki-image-style-border="true"]]
117
Pascal Meyer 18.3 118 = Erstellung eines Sprints =
Pascal Meyer 17.1 119
Pascal Meyer 20.2 120 In GitLab erfolgt die Erstellung eines Sprints in sogenannten **"Milestones"** (Meilensteine). Diese Option ist in der Projektnavigationsleiste unter dem Reiter **"Milestones" **vorzufinden. Um einen neuen Sprint zu erstellen wird die **"New Milestone"**-Option ausgewählt.
Pascal Meyer 18.2 121
Pascal Meyer 33.5 122 [[image:Sprint1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 18.3 123
Pascal Meyer 20.4 124 Damit ein neuer Sprint erstellt werden kann, wird der Sprint mit einem Titel, einem Start- sowie Enddatum und einer Beschreibung versehen. Das Sprintziel sollte in der Beschreibung festgehalten werden. Im unten aufgeführten Beispiel ist die Registrierung und die Anmeldung das angestrebte Sprintziel. Gespeichert wird der Sprint durch die "**Create milestone"**-Funktion
Pascal Meyer 20.2 125
Pascal Meyer 33.5 126 [[image:Sprint2.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 20.2 127
Pascal Meyer 33.4 128 [[image:Sprint3.png||data-xwiki-image-style-border="true"]]
129
Pascal Meyer 69.2 130 == Sprint-Backlog ==
131
Pascal Meyer 24.2 132 Jetzt wurde erfolgreich ein Sprint erstellt. Jedoch fehlen bisher noch die Issues die benötigt werden um das Sprintziel zu erreichen. Dafür wird erneut der Reiter **"Issue boards" **(der Product-Backlog) angesteuert. Anschließend wird die Funktion **"New list"** ausgewählt.
Pascal Meyer 20.2 133
Pascal Meyer 33.4 134 [[image:Sprint4.1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 20.3 135
Pascal Meyer 24.4 136 Hierbei werden wieder verschiedene Optionen angeboten. Für die Erstellung eines Sprints bzw. der Durchführung der Sprintplanung, wird die Option **"Milestone"** und der eben erstellte Sprint als **"Value"** ausgewählt. Anschließend wird der Vorgang durch die **"Add to board"**-Funktion bestätigt.
Pascal Meyer 22.1 137
Pascal Meyer 33.4 138 [[image:Sprint5.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 22.3 139
Pascal Meyer 33.3 140 [[image:Sprint6.1.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 24.2 141
Pascal Meyer 27.5 142 Somit wurde erfolgreich ein sogenannter **Sprint-Backlog** (siehe [[Informationen zu Scrum>>doc:Main.Scrum.WebHome]]) erstellt. In der Sprint-Planungsphase wird vom kompletten Projektteam festgelegt, welche Issues im Sprint umgesetzt werden sollen um das selbst definierte Sprint-Ziel zu erreichen. Nachdem das Team sich geeinigt hat, werden die Issues aus dem Product-Backlog, per "Drag and Drop" (Ziehen und Ablegen) in dem Sprint-Backlog abgelegt.
Pascal Meyer 24.2 143
Pascal Meyer 33.3 144 [[image:Sprint8.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 24.3 145
Pascal Meyer 69.2 146 == Schätzungen ==
Pascal Meyer 26.1 147
Pascal Meyer 69.2 148 Anschließend müssen die Issues geschätzt werden (siehe [[Schätzen>>doc:Main.Scrum.WebHome||anchor="HSchE4tzenvonAufwE4nden"]]). Dieser Vorgang dient der Schärfung des Verständnisses des gesamtem Projektteams. Hierbei ist es wichtig sich auf eine Werteskala (bspw. Fibonacci) zu einigen (diese sollte über die gesamte Projektdauer beibehalten werden). Die Ergebnisse werden dann direkt in den Issues unter dem Punkt "Weight" festgehalten.
149
Pascal Meyer 33.3 150 [[image:SprintS.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 27.5 151
Pascal Meyer 30.3 152 Die Sprint-Planung ist somit abgeschlossen und der fertiggestellte Sprint ist unter dem Reiter **"Milestones" **vorzufinden.
Pascal Meyer 30.2 153
Pascal Meyer 33.2 154 [[image:SprintE.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 30.3 155
Pascal Meyer 32.2 156 [[image:SprintF.png||data-xwiki-image-style-border="true"]]
157
Pascal Meyer 36.2 158 = Erstellung eines Wikis =
159
Pascal Meyer 44.1 160 Im Softwareprojekt müssen viele Daten dokumentiert (siehe [[Anforderungsanalys>>doc:Main.Aufgabenstellung.WebHome||anchor="Teilaufgabe2:Anforderungsanalyse28Dokumentation29"]] und [[Entwurf>>doc:Main.Aufgabenstellung.WebHome||anchor="HTeilaufgabe3:Entwurf28Dokumentation29"]] sowie [[Dokumentation>>doc:Main.Anforderungen Software.WebHome||anchor="HAnforderungen:Dokumentation"]]) werden und unter anderem auch ein Projekttagebuch (siehe [[Projekttagebuch>>doc:Main.Anforderungen Gruppen.WebHome||anchor="HProjekttagebuch"]] geführt werden. Dies wird in der Wiki-Funktion von GitLab umgesetzt. Diese Option ist in der Projektnavigationsleiste unter dem Reiter **"Wiki" **vorzufinden.
Pascal Meyer 37.2 161
162 [[image:Wiki1.png||data-xwiki-image-style-border="true"]]
163
Pascal Meyer 38.2 164 [[image:Wiki2.png||data-xwiki-image-style-border="true"]]
165
Pascal Meyer 39.3 166 Im GitLab-Wiki muss die erste Seite die sogenannte **"Home"**-Seite sein. Sonst wird das Wiki nicht korrekt erzeugt. Die Seite wird mit der **"Create page"**-Funktion erstellt.
Pascal Meyer 39.2 167
168 [[image:Wiki3.png||data-xwiki-image-style-border="true"]]
Pascal Meyer 39.4 169
Pascal Meyer 43.1 170 Um weitere Seiten zu erstellen, wird in der "Page"-Hierachie das "+" unter Home ausgewählt. Nach Erstellung der neuen Seite, wird diese wieder mit der **"Create page"**-Funktion erstellt.
Pascal Meyer 39.5 171
Pascal Meyer 40.2 172 [[image:Wiki4.png||data-xwiki-image-style-border="true"]]
173
Sebastian Beyer 51.1 174 (% class="wikigeneratedid" id="H" %)
175 [[image:Wiki5.png||data-xwiki-image-style-border="true"]]
Sebastian Beyer 45.2 176
177 = Zeiterfassung in GitLab =
178
Sebastian Beyer 52.3 179 Im Rahmen des Softwareprojekts sollt ihr eure Arbeitszeit präzise festhalten. Dazu könnt ihr direkt auf angelegten Issues/Tasks/User Stories in dem Bereich **Time tracking** eure Arbeitszeit Aufgabenspezifisch eintragen. In dem Fenster könnt ihr eintragen wie viel Zeit ihr gearbeitet habt, an welchem Tag ihr gearbeitet habt, um nachträgliches verbuchen von Arbeitszeit zu ermöglichen, und eine kleine Zusammenfassung angeben. Sollte bereits Zeit erfasst worden sein, muss über das Plus (siehe Bild oben rechts im roten Rahmen) Zeit gebucht werden.[[image:1754139824426-497.png]]