Skip to content
Snippets Groups Projects
Commit e0d9ff07 authored by Johannes Keyser's avatar Johannes Keyser
Browse files

Some more cleanups of Jekyll/Kramdown formatting. 

See #12.
parent b898b02a
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
de/Hilfe.md
+ 8
− 30
View file @ e0d9ff07
# Hilfe # Hilfe
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. 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) nicht ersetzen.
Für spezifische Informationen zu JLU GitLab, siehe [Informationen](Informationen.md). Für spezifische Informationen zu JLU GitLab, siehe [Informationen](Informationen.md).
## Inhalt {#toc}
[[_TOC_]] [[_TOC_]]
<!-- NOTE dies ist (derzeit) nur eine manuell verwaltete Liste. -->
- [Wichtige Konzepte](#essential_terms) ## Wichtige Konzepte
- [Git Begriffe](#terms_git)
- [GitLab Begriffe](#terms_gitlab)
- [Wie benutzt man GitLab?](#how_to_gitlab)
- [Erste Schritte](#first_steps)
- [Sichtbarkeit von Projekten](#project_visibility)
- [Nutzerrollen in Projekten](#project_roles)
- [Berechtigungen als *Guest*](#project_guest)
- [Berechtigungen als *Reporter*](#project_reporter)
- [Berechtigungen als *Developer*](#project_developer)
- [Berechtigungen als *Maintainer*](#project_maintainer)
- [Berechtigungen als *Owner*](#project_owner)
- [Nutzergruppen](#group)
- [Sichtbarkeit von Gruppen](#group_visibility)
- [Nutzerrollen in Gruppen](#group_roles)
- [Einstellungen, die private Informationen betreffen](#settings_privacy)
- [Letzte Schritte](#last_steps)
- [Weitere Hilfe](#more_help)
## Wichtige Konzepte {#essential_terms}
Git und GitLab sind vielschichtige Werkzeuge mit vielen technischen Konzepten und Begriffen. Git und GitLab sind vielschichtige Werkzeuge mit vielen technischen Konzepten und Begriffen.
Da deren Entwicklung und Namensschöpfung auf Englisch stattfindet, sind diese bisher nur teilweise in andere Sprachen übersetzt worden. Da deren Entwicklung und Namensschöpfung auf Englisch stattfindet, sind diese bisher nur teilweise in andere Sprachen übersetzt worden.
Um die weiteren Hilfestellungen (z.B. bezüglich Lese- und Schreibzugriff) kurz und verständlich zu halten, werden hier die wichtigsten Begriffe allgemeinverständlich erklärt. Um die weiteren Hilfestellungen (z.B. bezüglich Lese- und Schreibzugriff) kurz und verständlich zu halten, werden hier die wichtigsten Begriffe allgemeinverständlich erklärt.
Dies ist nur eine gutgemeinte Übersicht; unter [weitere Hilfe](#more_help) ist eine Sammlung von Links um sich mit diesen Konzepten vertraut zu machen. Dies ist nur eine gutgemeinte Übersicht; unter [weitere Hilfe](#weitere-hilfe) ist eine Sammlung von Links um sich mit diesen Konzepten vertraut zu machen.
### Git-Begriffe {#terms_git} ### Git-Begriffe
- [*Git*](https://de.wikipedia.org/wiki/Git){:target="_blank"} ist der Name einer Software für Versionskontrolle von Dateien. - [*Git*](https://de.wikipedia.org/wiki/Git) ist der Name einer Software für Versionskontrolle von Dateien.
- Ein *Repository* ist eine Sammlung von Dateien, deren Bearbeitungsverlauf in Schnappschüssen versioniert wird. - Ein *Repository* ist eine Sammlung von Dateien, deren Bearbeitungsverlauf in Schnappschüssen versioniert wird.
Mit Git kann man beliebig viele unterschiedliche Repositorien verwalten. Mit Git kann man beliebig viele unterschiedliche Repositorien verwalten.
- Ein *Commit* ist ein Schnappschuss der Daten im Repository. - Ein *Commit* ist ein Schnappschuss der Daten im Repository.
...@@ -48,7 +26,7 @@ Dies ist nur eine gutgemeinte Übersicht; unter [weitere Hilfe](#more_help) ist ...@@ -48,7 +26,7 @@ Dies ist nur eine gutgemeinte Übersicht; unter [weitere Hilfe](#more_help) ist
- Die Git-Befehle *pull* und *push* können Branches von Git-Repositorien auf unterschiedlichen Geräten synchronisieren (wie etwa dem eigenen Computer und JLU GitLab). - Die Git-Befehle *pull* und *push* können Branches von Git-Repositorien auf unterschiedlichen Geräten synchronisieren (wie etwa dem eigenen Computer und JLU GitLab).
Sobald zwei Repositorien synchronisiert wurden, beinhalten beide eine Kopie aller Daten, d.h. den gesamten Verlauf von Schnappschüssen. Sobald zwei Repositorien synchronisiert wurden, beinhalten beide eine Kopie aller Daten, d.h. den gesamten Verlauf von Schnappschüssen.
### GitLab-Begriffe {#terms_gitlab} ### GitLab-Begriffe
- Ein *Projekt* auf (JLU) GitLab enthält fast immer ein Git-Repository, und bietet viele zusätzliche Funktionen für dessen Verwaltung. - Ein *Projekt* auf (JLU) GitLab enthält fast immer ein Git-Repository, und bietet viele zusätzliche Funktionen für dessen Verwaltung.
Zusätzlich bietet GitLab mehrere Systeme um Quellcode eines Projekts automatisch auszuführen, z.B. um Tests auszuführen oder eine Webseite (wie diese) zu erstellen. Zusätzlich bietet GitLab mehrere Systeme um Quellcode eines Projekts automatisch auszuführen, z.B. um Tests auszuführen oder eine Webseite (wie diese) zu erstellen.
...@@ -268,7 +246,7 @@ Beachten Sie, dass Sie ihr Konto nicht sofort löschen können, falls Sie die ei ...@@ -268,7 +246,7 @@ Beachten Sie, dass Sie ihr Konto nicht sofort löschen können, falls Sie die ei
In diesem Fall müssen Sie mindestens ein anderes Mitglied als *Owner* einstellen, oder die betreffende Gruppe löschen (z.B. falls Sie das einzige Mitglied sind). In diesem Fall müssen Sie mindestens ein anderes Mitglied als *Owner* einstellen, oder die betreffende Gruppe löschen (z.B. falls Sie das einzige Mitglied sind).
## Weitere Hilfe {#more_help} ## Weitere Hilfe
TODO: Mehr nützliche Links, evtl. in Kategorien; GitLab selbst hat noch eine Menge. TODO: Mehr nützliche Links, evtl. in Kategorien; GitLab selbst hat noch eine Menge.
......
de/Informationen.md
+ 35
− 57
View file @ e0d9ff07
--- # Informationen
layout: page
title: Informationen [[_TOC_]]
permalink: /informationen/
ref: infos ## Was ist JLU GitLab?
lang: de
--- JLU GitLab ist eine [GitLab-Webanwendung](https://de.wikipedia.org/wiki/GitLab).
## Inhalte {#toc}
<!-- NOTE this is (currently?) just a manually maintained list. -->
- [Was ist JLU GitLab?](#what_is_jlugitlab)
- [Anwendungsmöglichkeiten](#use_cases)
- [Keine Speicherung von Forschungsdaten](#research_data)
- [Wer kann JLU GitLab benutzen?](#potential_users)
- [Wie kann ich JLU GitLab benutzen?](#how_to_use)
- [Auflösung des Nutzungskontos](#deletion_account)
- [Was passiert, wenn ich die JLU verlasse?](#leaving_JLU)
- [Was passiert, wenn meine g- oder s-Kennung ungültig wird?](#deletion_account_invalid)
- [Was passiert mit meinen Daten, wenn mein Konto gelöscht wird?](#deletion_userdata)
- [Wer betreibt JLU GitLab?](#maintainers)
- [Die Ziele von JLU GitLab](#our_goals)
- [Zukunftspläne](#future_plans)
- [Kontaktinformationen](#contact)
## Was ist JLU GitLab? {#what_is_jlugitlab}
JLU GitLab ist eine [GitLab-Webanwendung](https://de.wikipedia.org/wiki/GitLab){:target="_blank"}.
GitLab ist ein vielseitiges Werkzeug für die Verwaltung von Projekten, die das Bearbeiten von Dateien involvieren. GitLab ist ein vielseitiges Werkzeug für die Verwaltung von Projekten, die das Bearbeiten von Dateien involvieren.
Kern jedes GitLab-Projekts ist ein [Git-Repository](https://de.wikipedia.org/wiki/Git){:target="_blank"}, mit dem der Bearbeitungsstand versioniert werden kann. Kern jedes GitLab-Projekts ist ein [Git-Repository](https://de.wikipedia.org/wiki/Git), mit dem der Bearbeitungsstand versioniert werden kann.
GitLab bietet für jedes Projekt zusätzlich ein Wiki, ein Ticketsystem, und vieles mehr. GitLab bietet für jedes Projekt zusätzlich ein Wiki, ein Ticketsystem, und vieles mehr.
JLU GitLab ist per Browser unter [https://gitlab.test.uni-giessen.de](https://gitlab.test.uni-giessen.de){:target="_blank"} erreichbar und wird auf Systemen der [Justus-Liebig-Universität (JLU) Gießen](https://www.uni-giessen.de/fbz/svc/hrz){:target="_blank"} betrieben. JLU GitLab ist per Browser unter [https://gitlab.test.uni-giessen.de](https://gitlab.test.uni-giessen.de) erreichbar und wird auf Systemen der [Justus-Liebig-Universität (JLU) Gießen](https://www.uni-giessen.de/fbz/svc/hrz) betrieben.
Die eingesetzte GitLab Community Edition ist als freie Software lizensiert, sodass JLU GitLab technisch und juristisch von [GitLab.com](https://gitlab.com){:target="_blank"} unabhängig ist. Die eingesetzte GitLab Community Edition ist als freie Software lizensiert, sodass JLU GitLab technisch und juristisch von [GitLab.com](https://gitlab.com) unabhängig ist.
JLU GitLab wird von einem [Team freiwilliger Mitarbeitenden](#maintainers) betrieben. JLU GitLab wird von einem [Team freiwilliger Mitarbeitenden](#maintainers) betrieben.
## Anwendungsmöglichkeiten {#use_cases} ## Anwendungsmöglichkeiten
* In [Good enough practices in scientific computing von G. Wilseon et. al. (2017)](http://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510){:target="_blank"} * In [Good enough practices in scientific computing von G. Wilseon et. al. (2017)](http://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510)
wird die Motivation und die Verwendung von Versionierungswerkzeugen für z.B. wissenschaftlichen Programmcode beschrieben. wird die Motivation und die Verwendung von Versionierungswerkzeugen für z.B. wissenschaftlichen Programmcode beschrieben.
* TODO: Weitere hinzufügen: Laborverwaltung, Schreiben und Publizieren, ... * TODO: Weitere hinzufügen: Laborverwaltung, Schreiben und Publizieren, ...
## Keine Speicherung von Forschungsdaten {#research_data} ## Keine Speicherung von Forschungsdaten
JLU GitLab ist derzeit nicht für die Speicherung von Forschungsdaten vorgesehen. JLU GitLab ist derzeit nicht für die Speicherung von Forschungsdaten vorgesehen.
Es wird hiervon ausdrücklich abgeraten. Es wird hiervon ausdrücklich abgeraten.
Für die Speicherung von Forschungsdaten stehen an der JLU die [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox){:target="_blank"} sowie [Netzlaufwerke](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html){:target="_blank"} zur Verfügung. Für die Speicherung von Forschungsdaten stehen an der JLU die [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox) sowie [Netzlaufwerke](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html) zur Verfügung.
Bei Fragen des Forschungsdatenmanagements hilft Ihnen [dieser FAQ](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/faq/){:target="_blank"} weiter oder wenden Sie sich per E-Mail an [forschungsdaten@uni-giessen.de](mailto:forschungsdaten@uni-giessen.de). Bei Fragen des Forschungsdatenmanagements hilft Ihnen [dieser FAQ](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/faq/) weiter oder wenden Sie sich per E-Mail an [forschungsdaten@uni-giessen.de](mailto:forschungsdaten@uni-giessen.de).
## Wer kann JLU GitLab benutzen? {#potential_users} ## Wer kann JLU GitLab benutzen?
Derzeit niemand; es muss erst eine [Benutzungsordnung]({{ '/benutzungsordnung/' | relative_url }}) geschrieben werden. Derzeit niemand; es müssen erst [Nutzungsbedingungen](Nutzungsbedingungen.md) geschrieben werden.
Sobald dies geschehen ist, können alle Studierenden und Mitarbeitenden mit einer gültigen s- oder g-Kennung ein Nutzungskonto eröffnen, sofern sie die Benutzungsordnung akzeptieren. Sobald dies geschehen ist, können alle Studierenden und Mitarbeitenden mit einer gültigen s- oder g-Kennung ein Nutzungskonto eröffnen, sofern sie die Benutzungsordnung akzeptieren.
Dies bedeutet, dass sich Sichtbarkeitsstufe *internal* von [Projekten]({{ '/hilfe/#project_visibility' | relative_url }}) und [Nutzergruppen]({{ '/hilfe/#group_visibility' | relative_url }}) auf diese Personengruppe bezieht. Dies bedeutet, dass sich Sichtbarkeitsstufe *internal* von [Projekten]({{ '/hilfe/#project_visibility' | relative_url }}) und [Nutzergruppen]({{ '/hilfe/#group_visibility' | relative_url }}) auf diese Personengruppe bezieht.
Bitte beachten Sie, dass JLU GitLab derzeit nur innerhalb des Universitätsnetzes erreichbar ist. Bitte beachten Sie, dass JLU GitLab derzeit nur innerhalb des Universitätsnetzes erreichbar ist.
Dies bedeutet, dass sich Sichtbarkeitsstufe *public* von [Projekten]({{ '/hilfe/#project_visibility' | relative_url }}) und [Nutzergruppen]({{ '/hilfe/#group_visibility' | relative_url }}) auf alle bezieht, die Zugriff auf das Universitätznetz haben. Dies bedeutet, dass sich Sichtbarkeitsstufe *public* von [Projekten]({{ '/hilfe/#project_visibility' | relative_url }}) und [Nutzergruppen]({{ '/hilfe/#group_visibility' | relative_url }}) auf alle bezieht, die Zugriff auf das Universitätznetz haben.
Von außerhalb ist der Zugriff über das [VPN der Universität](https://www.uni-giessen.de/fbz/svc/hrz/svc/netz/campus/vpn){:target="_blank"} möglich. Von außerhalb ist der Zugriff über das [VPN der Universität](https://www.uni-giessen.de/fbz/svc/hrz/svc/netz/campus/vpn) möglich.
## Wie kann ich JLU GitLab benutzen? {#how_to_use} ## Wie kann ich JLU GitLab benutzen? {#how_to_use}
...@@ -79,18 +57,18 @@ Nutzungskontos von JLU GitLab können auf verschiedene Weisen aufgelöst werden: ...@@ -79,18 +57,18 @@ Nutzungskontos von JLU GitLab können auf verschiedene Weisen aufgelöst werden:
Unten finden Sie eine [Übersicht welche Daten mitgelöscht werden](#deletion_userdata), wenn Ihr Konto gelöscht wird. Unten finden Sie eine [Übersicht welche Daten mitgelöscht werden](#deletion_userdata), wenn Ihr Konto gelöscht wird.
### Was passiert, wenn ich die JLU verlasse? {#leaving_JLU} ### Was passiert, wenn ich die JLU verlasse?
Wenn Sie die Universität verlassen (z.B. Vertragsende, Exmatrikulation), wird auch innerhalb weniger Wochen Ihre [g- oder s-Kennung ungültig](#deletion_account_invalid). Wenn Sie die Universität verlassen (z.B. Vertragsende, Exmatrikulation), wird auch innerhalb weniger Wochen Ihre [g- oder s-Kennung ungültig](#deletion_account_invalid).
Für diesen Vorgang ist das [HRZ](https://www.uni-giessen.de/fbz/svc/hrz){:target="_blank"} zuständig; bei Fragen dazu kontaktieren bitte dieses. Für diesen Vorgang ist das [HRZ](https://www.uni-giessen.de/fbz/svc/hrz) zuständig; bei Fragen dazu kontaktieren bitte dieses.
### Was passiert, wenn meine g- oder s-Kennung ungültig wird? {#deletion_account_invalid} ### Was passiert, wenn meine g- oder s-Kennung ungültig wird?
Wenn Ihre g- or s-Kennung ungültig wird, wird Ihr Nutzungskonto auf JLU GitLab automatisch innerhalb von 24 Stunden blockiert. Wenn Ihre g- or s-Kennung ungültig wird, wird Ihr Nutzungskonto auf JLU GitLab automatisch innerhalb von 24 Stunden blockiert.
Wenn Ihr Konto blockiert ist, können Sie sich nicht mehr in JLU GitLab einloggen. Wenn Ihr Konto blockiert ist, können Sie sich nicht mehr in JLU GitLab einloggen.
Nachdem Ihr Konto 6 Monate lang blockiert war, wird es gelöscht, siehe unten. Nachdem Ihr Konto 6 Monate lang blockiert war, wird es gelöscht, siehe unten.
### Was passiert mit meinen Daten, wenn mein Konto gelöscht wird? {#deletion_userdata} ### Was passiert mit meinen Daten, wenn mein Konto gelöscht wird?
Wie viele Ihrer Daten gelöscht werden, hängt davon ab, wie Sie JLU GitLab genutzt haben. Wie viele Ihrer Daten gelöscht werden, hängt davon ab, wie Sie JLU GitLab genutzt haben.
Prinzipiell wird Ihr Konto mitsamt allen Ihren persönlichen Daten gelöscht. Prinzipiell wird Ihr Konto mitsamt allen Ihren persönlichen Daten gelöscht.
...@@ -105,11 +83,11 @@ Vereinfacht gesagt werden Ihr Konto und alle Ihre eigenen Projekte gelöscht. ...@@ -105,11 +83,11 @@ Vereinfacht gesagt werden Ihr Konto und alle Ihre eigenen Projekte gelöscht.
Allerdings werden Daten, die Sie in Projekten von anderen Personen oder ([nicht verwaister](#deletion_groups)) Gruppen beigetragen haben nicht gelöscht – aber soweit möglich anonymisiert. Allerdings werden Daten, die Sie in Projekten von anderen Personen oder ([nicht verwaister](#deletion_groups)) Gruppen beigetragen haben nicht gelöscht – aber soweit möglich anonymisiert.
Weiter unten finden Sie [genauere Details](#deletion_details). Weiter unten finden Sie [genauere Details](#deletion_details).
#### Löschen verwaister Gruppen und deren Projekte {#deletion_groups} #### Löschen verwaister Gruppen und deren Projekte
Falls keine weiteren Gruppenmitglieder existieren, wird die Gruppe als verwaist angesehen und mitsamt allen zugeordneten Projekte auch gelöscht. Falls keine weiteren Gruppenmitglieder existieren, wird die Gruppe als verwaist angesehen und mitsamt allen zugeordneten Projekte auch gelöscht.
#### Genauere Details {#deletion_details} #### Genauere Details
Um mehr Details zu erläutern, bedient sich die folgende Erklärung einiger [wichtiger Konzepte von Git und GitLab]({{ '/hilfe/#essential_terms' | relative_url }}). Um mehr Details zu erläutern, bedient sich die folgende Erklärung einiger [wichtiger Konzepte von Git und GitLab]({{ '/hilfe/#essential_terms' | relative_url }}).
...@@ -131,18 +109,18 @@ Hierbei ist wichtig, dass die Commits ihren tatsächlichen Namen und E-Mail-Adre ...@@ -131,18 +109,18 @@ Hierbei ist wichtig, dass die Commits ihren tatsächlichen Namen und E-Mail-Adre
Lesen Sie über [Einstellmöglickeiten bezüglich privater Informationen]({{ '/hilfe/#settings_privacy' | relative_url }}) um diese nach Ihren Wünschen einzurichten. Lesen Sie über [Einstellmöglickeiten bezüglich privater Informationen]({{ '/hilfe/#settings_privacy' | relative_url }}) um diese nach Ihren Wünschen einzurichten.
--> -->
## Wer betreibt JLU GitLab? {#maintainers} ## Wer betreibt JLU GitLab?
JLU GitLab wird von einer Kooperation aus freiwilligen Mitarbeitenden der Fachbereiche und der [Universitätsbibliothek](https://www.uni-giessen.de/ub/de){:target="_blank"} unter Einhaltung der [Richtlinien für die IT-Systemadministration an der JLU Gießen](https://www.uni-giessen.de/fbz/mug/2/pdf/2_26_30_4){:target="_blank"} betrieben. JLU GitLab wird von einer Kooperation aus freiwilligen Mitarbeitenden der Fachbereiche und der [Universitätsbibliothek](https://www.uni-giessen.de/ub/de) unter Einhaltung der [Richtlinien für die IT-Systemadministration an der JLU Gießen](https://www.uni-giessen.de/fbz/mug/2/pdf/2_26_30_4) betrieben.
Wir arbeiten in Rücksprache mit der [JLU-internen IKM-AG](https://www.uni-giessen.de/org/cio/cio/ikm-ag){:target="_blank"} und wir nutzen für den Betrieb ausschließlich Infrastruktur des [Hochschulrechenzentrums](https://www.uni-giessen.de/fbz/svc/hrz){:target="_blank"}. Wir arbeiten in Rücksprache mit der [JLU-internen IKM-AG](https://www.uni-giessen.de/org/cio/cio/ikm-ag) und wir nutzen für den Betrieb ausschließlich Infrastruktur des [Hochschulrechenzentrums](https://www.uni-giessen.de/fbz/svc/hrz).
Wir sind immer auf der Suche nach weiteren Freiwilligen die uns unterstützen wollen. Wir sind immer auf der Suche nach weiteren Freiwilligen die uns unterstützen wollen.
Bitte kontaktieren Sie uns, falls Sie mehr über unsere Arbeitsweise und Entscheidungsfindung wissen möchten. Bitte kontaktieren Sie uns, falls Sie mehr über unsere Arbeitsweise und Entscheidungsfindung wissen möchten.
Wir sind auf verschiedene Weisen erreichbar, siehe [Kontaktinformation](#contact). Wir sind auf verschiedene Weisen erreichbar, siehe [Kontaktinformation](#Kontaktinformation).
## Die Ziele von JLU GitLab {#our_goals} ## Die Ziele von JLU GitLab
JLU GitLab dient zunächst der Bedarfserfassung innerhalb der JLU und der Evaluation der Funktionalitäten im Forschungskontext. JLU GitLab dient zunächst der Bedarfserfassung innerhalb der JLU und der Evaluation der Funktionalitäten im Forschungskontext.
Wir glauben, dass Git und GitLab die besten zeitgemäßen Werkzeuge sind, um die Software und Dokumentation unserer Forschungsprojekte zu verwalten. Wir glauben, dass Git und GitLab die besten zeitgemäßen Werkzeuge sind, um die Software und Dokumentation unserer Forschungsprojekte zu verwalten.
...@@ -151,23 +129,23 @@ Nur eine lokal installierte, frei lizensierte Plattform wie GitLab kann langfris ...@@ -151,23 +129,23 @@ Nur eine lokal installierte, frei lizensierte Plattform wie GitLab kann langfris
In diesem Zusammenhang scheint erwähnenswert, dass die Dokumentation und Software, die zum Verständnis von Forschungsdaten notwendig ist, laut der [Forschungsdaten-Leitlinie der JLU](https://www.uni-giessen.de/mug/5/pdf/forschung/5_00_00_1) selbst als Forschungsdaten gelten. In diesem Zusammenhang scheint erwähnenswert, dass die Dokumentation und Software, die zum Verständnis von Forschungsdaten notwendig ist, laut der [Forschungsdaten-Leitlinie der JLU](https://www.uni-giessen.de/mug/5/pdf/forschung/5_00_00_1) selbst als Forschungsdaten gelten.
--> -->
## Zukunftspläne {#future_plans} ## Zukunftspläne
Nachdem JLU GitLab universitätsintern nutzbar ist, haben wir weitere Pläne um es noch nützlicher zu machen. Nachdem JLU GitLab universitätsintern nutzbar ist, haben wir weitere Pläne um es noch nützlicher zu machen.
Wir würden gerne... Wir würden gerne...
- ...den Zugang zu JLU GitLab direkt aus dem Internet ermöglichen, ohne VPN - ...den Zugang zu JLU GitLab direkt aus dem Internet ermöglichen, ohne VPN
- ...Benutzungskonten auch für Menschen von außerhalb der JLU ermöglichen - ...Benutzungskonten auch für Menschen von außerhalb der JLU ermöglichen
- ...der Möglichkeit nachgehen wie Inhalte per [GitLab Pages](https://docs.gitlab.com/ce/user/project/pages/){:target="_blank"} publiziert werden können - ...der Möglichkeit nachgehen wie Inhalte per [GitLab Pages](https://docs.gitlab.com/ce/user/project/pages/) publiziert werden können
- ...die Verwendung von [Git Large File Storage (LFS)](https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html){:target="_blank"} erörtern - ...die Verwendung von [Git Large File Storage (LFS)](https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html) erörtern
## Kontakt {#contact} ## Kontakt
Für Anfragen nach Hilfe und Unterstützung schreiben Sie bitte eine Email an die Mailingliste für Hilfe, [gitlab-help@lists.uni-giessen.de](mailto:gitlab-help@lists.uni-giessen.de). Für Anfragen nach Hilfe und Unterstützung schreiben Sie bitte eine Email an die Mailingliste für Hilfe, [gitlab-help@lists.uni-giessen.de](mailto:gitlab-help@lists.uni-giessen.de).
Für alles Weitere kontaktieren Sie das [Team der Betreibenden](#maintainers) unter unserer internen Mailingliste, [gitlab-admin@lists.uni-giessen.de](mailto:gitlab-admin@lists.uni-giessen.de). Für alles Weitere kontaktieren Sie das [Team der Betreibenden](#maintainers) unter unserer internen Mailingliste, [gitlab-admin@lists.uni-giessen.de](mailto:gitlab-admin@lists.uni-giessen.de).
Falls Sie Neuigkeiten über JLU GitLab erfahren möchten, können sie die Mailingliste [gitlab-news@lists.uni-giessen.de](mailto:gitlab-news@lists.uni-giessen.de) oder den [RSS feed]({{ '/de_feed.xml' | relative_url }}) abbonieren. Falls Sie Neuigkeiten über JLU GitLab erfahren möchten, können sie die Mailingliste [gitlab-news@lists.uni-giessen.de](mailto:gitlab-news@lists.uni-giessen.de) abbonieren.
Außerdem können Sie die [Protokolle der IKM-AG](https://www.uni-giessen.de/org/cio/cio/ikm-ag){:target="_blank"} verfolgen (nur intern verfügbar). Außerdem können Sie die [Protokolle der IKM-AG](https://www.uni-giessen.de/org/cio/cio/ikm-ag) verfolgen (nur intern verfügbar).
de/Nutzungsbedingungen.md
+ 2
− 8
View file @ e0d9ff07
--- # Nutzungsbedingungen
layout: page
title: Benutzungsordnung
permalink: /benutzungsordnung/
ref: termsofservice
lang: de
---
Die Benutzungsordnung für JLU GitLab wird derzeit in Rücksprache mit dem Hochschulrechenzentrum und dem Personalrat entworfen. Die Nutzungsbedingungen für JLU GitLab wird derzeit in Rücksprache mit dem Hochschulrechenzentrum und dem Personalrat entworfen.
en/Help.md
+ 12
− 39
View file @ e0d9ff07
--- # Help
layout: page
title: Help Here you find some first aid on the use of JLU GitLab, but it cannot replace the [official user help](https://gitlab.test.uni-giessen.de/help/user/index.md).
permalink: /help/ For specific information about JLU GitLab, see [information](Information.md).
ref: help
lang: en [[_TOC_]]
---
Here you find some first aid on the use of JLU GitLab, but it cannot replace the [official user help](https://gitlab.test.uni-giessen.de/help/user/index.md){:target="_blank"}. ## Important concepts
For specific information about JLU GitLab, see [information]({{ '/information/#what_is_jlugitlab' | relative_url }}).
## Content {#toc}
<!-- NOTE this is (currently) just a manually maintained list. -->
- [Important concepts](#essential_terms)
- [Git terminology](#terms_git)
- [GitLab terminology](#terms_gitlab)
- [How to use GitLab?](#how_to_gitlab)
- [First steps](#first_steps)
- [Visibility of projects](#project_visibility)
- [User roles in projects](#project_roles)
- [Permissions as *Guest*](#project_guest)
- [Permissions as *Reporter*](#project_reporter)
- [Permissions as *Developer*](#project_developer)
- [Permissions as *Maintainer*](#project_maintainer)
- [Permissions as *Owner*](#project_owner)
- [User groups](#group)
- [Visibility of groups](#group_visibility)
- [User roles in groups](#group_roles)
- [Settings concerning private information](#settings_privacy)
- [Last steps](#last_steps)
- [How to delete my account?](#deletion_account)
- [Further help](#more_help)
## Important concepts {#essential_terms}
Git and GitLab are versatile tools with many technical concepts and terms. Git and GitLab are versatile tools with many technical concepts and terms.
Because their development and terminology is created in English, these terms have been only partially translated into other languages. Because their development and terminology is created in English, these terms have been only partially translated into other languages.
To keep the following help entries (e.g. regarding read and write permissions) short and comprehensible, the essential terms are explained here in plain English. To keep the following help entries (e.g. regarding read and write permissions) short and comprehensible, the essential terms are explained here in plain English.
This is only a well-intended overview; [further help](#more_help) provides a collection of links to familiarize yourself with these concepts. This is only a well-intended overview; [further help](#further-help) provides a collection of links to familiarize yourself with these concepts.
### Git terminology {#terms_git} ### Git terminology
- [*Git*](https://en.wikipedia.org/wiki/Git){:target="_blank"} is the name of a software for version control of files. - [*Git*](https://en.wikipedia.org/wiki/Git){:target="_blank"} is the name of a software for version control of files.
- A *repository* is a collection of files where edits are versioned as a history of snapshots. - A *repository* is a collection of files where edits are versioned as a history of snapshots.
...@@ -275,7 +248,7 @@ Note that you cannot immediately delete your account if you are the only *Owner* ...@@ -275,7 +248,7 @@ Note that you cannot immediately delete your account if you are the only *Owner*
In this case, you must give the *Owner* role to at least one other member, or delete the group in question (e.g. if you are the only remaining member). In this case, you must give the *Owner* role to at least one other member, or delete the group in question (e.g. if you are the only remaining member).
## Further help {#more_help} ## Further help
TODO: More useful links, maybe with explanations. GitLab itself has a bunch more. TODO: More useful links, maybe with explanations. GitLab itself has a bunch more.
......
en/Information.md
+ 32
− 53
View file @ e0d9ff07
--- # Information
layout: page
title: Information [[_TOC_]]
permalink: /information/
ref: infos
lang: en ## What is JLU GitLab?
---
JLU GitLab is a [GitLab web service](https://en.wikipedia.org/wiki/GitLab).
## Content {#toc}
<!-- NOTE this is (currently?) just a manually maintained list. -->
- [What is JLU GitLab?](#what_is_jlugitlab)
- [Use cases](#use_cases)
- [No storage of research data](#research_data)
- [Who may use JLU GitLab?](#potential_users)
- [How can I use JLU GitLab?](#how_to_use)
- [Account termination](#deletion_account)
- [What happens when I leave JLU?](#leaving_JLU)
- [What happens if my g- or s-account becomes invalid?](#deletion_account_invalid)
- [What happens to my data when my account is deleted?](#deletion_userdata)
- [Who is maintaining JLU GitLab?](#maintainers)
- [The goals of JLU GitLab](#our_goals)
- [Future outlook](#future_plans)
- [Contact information](#contact)
## What is JLU GitLab? {#what_is_jlugitlab}
JLU GitLab is a [GitLab web service](https://en.wikipedia.org/wiki/GitLab){:target="_blank"}.
GitLab is a versatile tool for the management of projects that involve file editing. GitLab is a versatile tool for the management of projects that involve file editing.
At the core of each GitLab project is a [Git repository](https://en.wikipedia.org/wiki/Git){:target="_blank"} that keeps versions of the edited files. At the core of each GitLab project is a [Git repository](https://en.wikipedia.org/wiki/Git) that keeps versions of the edited files.
For each project, GitLab also provides a wiki, an issue tracker, and much more. For each project, GitLab also provides a wiki, an issue tracker, and much more.
JLU GitLab is accessible with a web browser at [https://gitlab.test.uni-giessen.de](https://gitlab.test.uni-giessen.de){:target="_blank"} and is hosted on systems of the [Justus Liebig University (JLU) Giessen](https://www.uni-giessen.de/fbz/svc/hrz){:target="_blank"}. JLU GitLab is accessible with a web browser at [https://gitlab.test.uni-giessen.de](https://gitlab.test.uni-giessen.de) and is hosted on systems of the [Justus Liebig University (JLU) Giessen](https://www.uni-giessen.de/fbz/svc/hrz).
The deployed GitLab Community Edition is licensed as free software, so JLU GitLab is technically and legally independent from [GitLab.com](https://gitlab.com){:target="_blank"}. The deployed GitLab Community Edition is licensed as free software, so JLU GitLab is technically and legally independent from [GitLab.com](https://gitlab.com).
JLU GitLab is maintained by a [team of voluntary employees](#maintainers). JLU GitLab is maintained by a [team of voluntary employees](#maintainers).
## Use cases {#use_cases} ## Use cases
* In [Good enough practices in scientific computing von G. Wilseon et. al. (2017)](http://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510){:target="_blank"} reasons and how to use tools for versioning scientific software and programming code are shown. * In [Good enough practices in scientific computing von G. Wilseon et. al. (2017)](http://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1005510) reasons and how to use tools for versioning scientific software and programming code are shown.
* TODO: Add more: lab management, writing and publishing, ... * TODO: Add more: lab management, writing and publishing, ...
## No storage of research data {#research_data} ## No storage of research data
JLU GitLab is currently not suited to store research data. JLU GitLab is currently not suited to store research data.
Such use is explicitly advised against. Such use is explicitly advised against.
For storage of research data, the JLU provides the [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox){:target="_blank"} as well as [network drives](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html){:target="_blank"}. For storage of research data, the JLU provides the [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox) as well as [network drives](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html).
For questions regarding management of research data, you find further help at [this FAQ](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/faq/){:target="_blank"} or write an E-Mail to [forschungsdaten@uni-giessen.de](mailto:forschungsdaten@uni-giessen.de). For questions regarding management of research data, you find further help at [this FAQ](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/faq/) or write an email to [forschungsdaten@uni-giessen.de](mailto:forschungsdaten@uni-giessen.de).
## Who may use JLU GitLab? {#potential_users} ## Who may use JLU GitLab?
Currently nobody; first, the [terms of service]({{ '/terms-of-service/' | relative_url }}) must be written. Currently nobody; first, the [terms of service]({{ '/terms-of-service/' | relative_url }}) must be written.
...@@ -58,7 +37,7 @@ This means that *internal* visibility of [projects]({{ '/help/#project_visibilit ...@@ -58,7 +37,7 @@ This means that *internal* visibility of [projects]({{ '/help/#project_visibilit
Please note that GitLab is currently only accessible within the university network. Please note that GitLab is currently only accessible within the university network.
This means that *public* visibility of [projects]({{ '/help/#project_visibility' | relative_url }}) or [groups]({{ '/help/#group_visibility' | relative_url }}) applies to anyone with access to the university network. This means that *public* visibility of [projects]({{ '/help/#project_visibility' | relative_url }}) or [groups]({{ '/help/#group_visibility' | relative_url }}) applies to anyone with access to the university network.
Members of the university can access from outside the university network through the [university VPN](https://www.uni-giessen.de/fbz/svc/hrz/svc/netz/campus/vpn){:target="_blank"}. Members of the university can access from outside the university network through the [university VPN](https://www.uni-giessen.de/fbz/svc/hrz/svc/netz/campus/vpn).
## How can I use JLU GitLab? {#how_to_use} ## How can I use JLU GitLab? {#how_to_use}
...@@ -81,15 +60,15 @@ Below you find an [overview what data will also be deleted](#deletion_userdata) ...@@ -81,15 +60,15 @@ Below you find an [overview what data will also be deleted](#deletion_userdata)
### What happens when I leave JLU? {#leaving_JLU} ### What happens when I leave JLU? {#leaving_JLU}
Once you leave the university (e.g. end of contract, exmatriculation), your [g- or s-account will become invalid](#deletion_account_invalid) within a few weeks. Once you leave the university (e.g. end of contract, exmatriculation), your [g- or s-account will become invalid](#deletion_account_invalid) within a few weeks.
The [IT service centre](https://www.uni-giessen.de/fbz/svc/hrz){:target="_blank"} is responsible for this procedure; please contact them if you have questions. The [IT service centre](https://www.uni-giessen.de/fbz/svc/hrz) is responsible for this procedure; please contact them if you have questions.
### What happens if my g- or s-account becomes invalid? {#deletion_account_invalid} ### What happens if my g- or s-account becomes invalid?
If your g- or s-account becomes invalid, your account on JLU GitLab will become blocked automatically within 24 hours. If your g- or s-account becomes invalid, your account on JLU GitLab will become blocked automatically within 24 hours.
If your account is blocked, you will not be able to log in to JLU GitLab. If your account is blocked, you will not be able to log in to JLU GitLab.
After your account has been blocked for 6 months, it will be deleted, see below. After your account has been blocked for 6 months, it will be deleted, see below.
### What happens to my data when my account is deleted? {#deletion_userdata} ### What happens to my data when my account is deleted?
How much of your data will be deleted depends on how you used JLU GitLab. How much of your data will be deleted depends on how you used JLU GitLab.
In principle, your account will be deleted along with all your personal data. In principle, your account will be deleted along with all your personal data.
...@@ -102,11 +81,11 @@ Roughly speaking, your account and all your own projects will be deleted. ...@@ -102,11 +81,11 @@ Roughly speaking, your account and all your own projects will be deleted.
However, data that you contributed to projects of other people or ([non-abandoned](#deletion_groups)) groups will not be deleted – but anonymized as much as possible. However, data that you contributed to projects of other people or ([non-abandoned](#deletion_groups)) groups will not be deleted – but anonymized as much as possible.
Further below, you find [more precise details](#deletion_details). Further below, you find [more precise details](#deletion_details).
#### Deletion of abandoned groups and their projects {#deletion_groups} #### Deletion of abandoned groups and their projects
If no other group members exist, the group is considered abandoned, and all its associated projects will be deleted as well. If no other group members exist, the group is considered abandoned, and all its associated projects will be deleted as well.
#### More precise details {#deletion_details} #### More precise details
To explain more details, the following explanation relies on some [important concepts of Git and GitLab]({{ '/help/#necessary_terms' | relative_url }}). To explain more details, the following explanation relies on some [important concepts of Git and GitLab]({{ '/help/#necessary_terms' | relative_url }}).
Once your account is deleted, also all data from your user profile will be deleted, along with all your own projects in your *namespace*. Once your account is deleted, also all data from your user profile will be deleted, along with all your own projects in your *namespace*.
...@@ -127,17 +106,17 @@ Importantly, commits may include your real name and email address, depending on ...@@ -127,17 +106,17 @@ Importantly, commits may include your real name and email address, depending on
You can read about [settings concerning your private information]({{ '/help/#settings_privacy' | relative_url }}) how to set them up according to your preferences. You can read about [settings concerning your private information]({{ '/help/#settings_privacy' | relative_url }}) how to set them up according to your preferences.
--> -->
## Who is maintaining JLU GitLab? {#maintainers} ## Who is maintaining JLU GitLab?
JLU GitLab is maintained by a team consisting of volunteers from the faculties and the [university library](https://www.uni-giessen.de/ub/en/){:target="_blank"}, in accordance with the [Guidelines for the IT-system administration at the JLU Giessen (in German)](https://www.uni-giessen.de/fbz/mug/2/pdf/2_26_30_4){:target="_blank"}. JLU GitLab is maintained by a team consisting of volunteers from the faculties and the [university library](https://www.uni-giessen.de/ub/en/), in accordance with the [Guidelines for the IT-system administration at the JLU Giessen (in German)](https://www.uni-giessen.de/fbz/mug/2/pdf/2_26_30_4).
We work in consultation with the [JLU-internal IKM work group](https://www.uni-giessen.de/org/cio/cio/ikm-ag){:target="_blank"}, and for service operations we exclusively use infrastructure of the [IT service centre](https://www.uni-giessen.de/fbz/svc/hrz){:target="_blank"}. We work in consultation with the [JLU-internal IKM work group](https://www.uni-giessen.de/org/cio/cio/ikm-ag), and for service operations we exclusively use infrastructure of the [IT service centre](https://www.uni-giessen.de/fbz/svc/hrz).
We are always looking for more volunteers who want to join our efforts. We are always looking for more volunteers who want to join our efforts.
Feel free to contact us if you want to know more about our our way of working and decision process. Feel free to contact us if you want to know more about our our way of working and decision process.
You can contact us in various ways, see the [contact information](#contact). You can contact us in various ways, see the [contact information](#contact).
## The goals of JLU GitLab {#our_goals} ## The goals of JLU GitLab
JLU GitLab first serves to assess demands across the JLU and for evaluation of its features in a research context. JLU GitLab first serves to assess demands across the JLU and for evaluation of its features in a research context.
We believe that currently, Git and GitLab provide the best tools to manage and document the software for our research. We believe that currently, Git and GitLab provide the best tools to manage and document the software for our research.
...@@ -146,17 +125,17 @@ Only a locally installed, freely licensed platform like GitLab can ensure our lo ...@@ -146,17 +125,17 @@ Only a locally installed, freely licensed platform like GitLab can ensure our lo
Within this context it seems noteworthy that the documentation and software necessary for the understanding of research data are themselves regarded as research data by [JLU's guideline on research data](https://www.uni-giessen.de/mug/5/pdf/forschung/5_00_00_1). Within this context it seems noteworthy that the documentation and software necessary for the understanding of research data are themselves regarded as research data by [JLU's guideline on research data](https://www.uni-giessen.de/mug/5/pdf/forschung/5_00_00_1).
--> -->
## Future outlook {#future_plans} ## Future plans
Once JLU GitLab is usable within the university, we have further plans to make it even more useful. Once JLU GitLab is usable within the university, we have further plans to make it even more useful.
We would like to... We would like to...
- ...make JLU GitLab accessible directly from the Internet, without VPN - ...make JLU GitLab accessible directly from the Internet, without VPN
- ...also allow accounts for people from outside the JLU - ...also allow accounts for people from outside the JLU
- ...investigate the possibility to publish content with [GitLab Pages](https://docs.gitlab.com/ce/user/project/pages/){:target="_blank"} - ...investigate the possibility to publish content with [GitLab Pages](https://docs.gitlab.com/ce/user/project/pages/)
- ...evaluate the use of [Git Large File Storage (LFS)](https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html){:target="_blank"} - ...evaluate the use of [Git Large File Storage (LFS)](https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html)
## Contact {#contact} ## Contact
For questions regarding help and support, please write an email to our support mailing list, [gitlab-help@lists.uni-giessen.de](mailto:gitlab-help@lists.uni-giessen.de). For questions regarding help and support, please write an email to our support mailing list, [gitlab-help@lists.uni-giessen.de](mailto:gitlab-help@lists.uni-giessen.de).
...@@ -164,5 +143,5 @@ For anything else, can contact the [team of maintainers](#maintainers) at our in ...@@ -164,5 +143,5 @@ For anything else, can contact the [team of maintainers](#maintainers) at our in
If you want to get receive news about JLU GitLab, you can subscribe to the mailing list [gitlab-news@lists.uni-giessen.de](mailto:gitlab-news@lists.uni-giessen.de) If you want to get receive news about JLU GitLab, you can subscribe to the mailing list [gitlab-news@lists.uni-giessen.de](mailto:gitlab-news@lists.uni-giessen.de)
or to the [RSS feed]({{ '/feed.xml' | relative_url }}). or to the [RSS feed]({{ '/feed.xml' | relative_url }}).
You can also follow the [protocols of the IKM work group](https://www.uni-giessen.de/org/cio/cio/ikm-ag){:target="_blank"} (only accessible internally, in German). You can also follow the [protocols of the IKM work group](https://www.uni-giessen.de/org/cio/cio/ikm-ag) (only accessible internally, in German).
en/README.md 0 → 100644
+ 8
− 0
View file @ e0d9ff07
# JLU GitLab Support
## [Help](Help.md)
## [Information](Information.md)
## [Terms of service](TermsOfService.md)
![](../images/logo_support_en.png)
en/TermsOfService.md
+ 1
− 7
View file @ e0d9ff07
--- # Terms of service
layout: page
title: Terms of service
permalink: /terms-of-service/
ref: termsofservice
lang: en
---
The terms of service for JLU GitLab are currently being drafted in coordination with the IT Service Centre and the staff council. The terms of service for JLU GitLab are currently being drafted in coordination with the IT Service Centre and the staff council.
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment