---
layout: page
title: Hilfe
permalink: /hilfe/
ref: help
lang: de
---

Hier finden Sie erste Hilfe zur Benutzung von JLU GitLab, aber diese kann [die offizielle Nutzerhilfe (auf Englisch)](https://gitlab.test.uni-giessen.de/help/user/index.md){:target="_blank"} nicht ersetzen.
Für spezifische Informationen zu JLU GitLab, siehe [Informationen]({{ '/informationen/#what_is_jlugitlab' | relative_url }}).

## Inhalt {#toc}

<!-- NOTE dies ist (derzeit) nur eine manuell verwaltete Liste. -->
- [Wie benutzt man GitLab?](#how_to_gitlab)
- [Erste Schritte](#first_steps)
- [Sichtbarkeit von Projekten](#visibility_projects)
- [Nutzerrollen in Projekten](#user_roles)
    - [Berechtigungen als *Guest*](#role_guest)
    - [Berechtigungen als *Reporter*](#role_reporter)
    - [Berechtigungen als *Developer*](#role_developer)
    - [Berechtigungen als *Maintainer*](#role_maintainer)
    - [Berechtigungen als *Owner*](#role_owner)
- [Nutzergruppen](#groups)
- [Einstellung von privater Informationen](#private_info)
- [Letzte Schritte](#last_steps)
- [Weitere Hilfe](#more_help)

## Wie benutzt man GitLab? {#how_to_gitlab}

TODO: Viele Kleinigkeiten mit Browser möglich, für umfangreichere Arbeit aber Git lokal installieren.

TODO: Hinweis auf Git-GUIs (ohne Empfehlung?).

TODO: Hinweis auf Git-Funktionen in Matlab und anderen IDEs?

## Erste Schritte {#first_steps}

TODO: Grobe Übersicht, links auf gute Ressourcen zum Weiterlernen ([siehe unten](#more_help)).

## Sichtbarkeit von Projekten {#visibility_projects}

Jedes Projekt hat eine Sichtbarkeits-Einstellung als entweder *private*, *internal* oder *public*.
Die Sichtbarkeit kann nur vom *Owner* des Projekts geändert werden (siehe [Nutzerrollen unten](#user_roles)).

- Projekte mit Sichtbarkeit *private* sind nur für die [Mitglieder des Projekts](#user_roles) einsehbar.
- Projekte mit Sichtbarkeit *internal* sind für alle Personen mit einem Nutzungskonto einsehbar, die eingeloggt sind.
  [Bitte lesen Sie hier, was dies im Fall von JLU GitLab bedeutet.]({{ '/informationen/#potential_users' | relative_url }})
- Projekte mit Sichtbarkeit *public* sind auch für alle Personen einsehbar, die kein Nutzungskonto haben.
  [Bitte lesen Sie hier, was dies im Fall von JLU GitLab bedeutet.]({{ '/informationen/#potential_users' | relative_url }})

Für mehr Details lesen Sie bitte die [offizielle Dokumentation (auf Englisch)](https://gitlab.test.uni-giessen.de/help/public_access/public_access.md#public-access){:target="_blank"}.

## Nutzerrollen in Projekten {#user_roles}

TODO: Fehlende Bedeutungen von *Reporter* bis *Owner*.

Wenn Sie andere Nutzende als Projektmitglied hinzufügen wollen, müssen Sie diesen auch eine bestimmte Rolle zuweisen:
Sie können zwischen *Guest*, *Reporter*, *Developer*, *Maintainer* oder *Owner* auswählen.
Jede dieser Rollen umfasst mehr Berechtigungen als die vorherige, siehe auch in der [offiziellen Dokumentation (auf Englisch)](https://gitlab.test.uni-giessen.de/help/user/permissions.md#project-members-permissions){:target="_blank"}.
<!-- NOTE: Der Einfachheit halber, lass uns unten die Berechtigungen von den Verträgen STARTER, PREMIUM, ULTIMATE weglassen; unter der Annahme dass diese nicht Teil der Community Edition sind. -->

### Berechtigungen als *Guest* {#role_guest}

Die *Guest*-Rolle ist für nicht-aktive Mitglieder die einige Inhalte lesen, und Tickets öffnen und kommentieren können.

Projektmitglieder in der *Guest*-Rolle können
das Projekt herunterladen,
Kommentare einbringen,
Projektdateien ansehen und Git-*pull*en,
Wikiseiten ansehen,
neue Tickets erstellen,
verwandte Tickets ansehen,
vertrauliche Tickets erstellen,
und selbsterstellte vertrauliche Tickets ansehen.

Wenn *Öffentliche Pipelines* in den *Projekteinstellungen > CI/CD* aktiviert ist, können sie zusätzlich
eine Liste der Jobs anschauen,
ein Job-Protokoll ansehen,
und Job-Artefakte durchsehen und herunterladen.

### Berechtigungen als *Reporter* {#role_reporter}

Die *Reporter*-Rolle ist für Mitglieder die mehr Einblick bekommen und im Ticketsystem arbeiten können.
Projektmitglieder mit der *Reporter*-Rolle habe folgende zusätzliche Berechtigungen im Vergleich zur *Guest*-Rolle:

Im Ticketsystem
können sie Tickets zuweisen und
mit Labels versehen,
Kommentare sperren,
und die Ticketliste und Labels verwalten.
*Reporter* können außerdem Codeausschnitte speichern,
den Status eines Commits einsehen,
eine Container Registry ansehen,
Umgebungen ansehen,
eine Liste von Merge-Requests ansehen,
Projekt-Statistiken ansehen,
und die Error-Tracking-Liste ansehen.
<!-- NOTE: Error Tracking (keine dt. Übersetzung) ist unter Vorgängen zu finden, man muss mit mit einem Sentry-Server verbinden. -->

### Berechtigungen als *Developer* {#role_developer}

TODO

### Berechtigungen als *Maintainer* {#role_maintainer}

TODO

### Berechtigungen als *Owner* {#role_owner}

TODO

## Nutzergruppen {#groups}

TODO: Gruppenmitglieder und deren Rollen und einhergehende Rechte.

TODO: Hinweis, dass Projekte in Gruppen nicht beim Austritt gelöscht werden, sofern noch andere Nutzende in der Gruppe sind.

[Ähnlich zur Sichtbarkeit von Projekten](#visibility_projects) kann die Sichtbarkeit von Gruppen auf *private*, *internal* oder *public* gesetzt werden, um den Zugriff entweder nur explizit ausgewählten Mitgliedern zu gewähren oder allen eingeloggten Nutzenden oder sogar allen Personen ohne Nutzungskonto.

## Einstellung von privater Informationen {#private_info}

TODO: Einstellung der Commit-Emailadresse (in GitLab und lokal), Profil und Aktivitäten unsichtbar machen, ...

## Letzte Schritte {#last_steps}

TODO: Erklärung, was wann bei Austritt aus der JLU gelöscht wird (Nutzerdaten, *eigene* Projekte, ...), und was nicht (Projekte in Gruppen inkl Tickets und Kommentare, Commits, ...).

Außer den Commits werden Daten anonymisiert (auf den Ghost-User übertragen).

## Weitere Hilfe {#more_help}

TODO: Mehr nützliche Links, evtl. in Kategorien.

- Die offizielle Nutzerhilfe für JLU GitLab (auf Englisch), <https://gitlab.test.uni-giessen.de/help/user/index.md>
- Kostenloses Online-Buch *Pro Git*, <https://git-scm.com/book/de>, teilweise auf Deutsch übersetzt