Newer
Older
permalink: /information/
ref: infos
lang: en
---
<!-- 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)
- [Deletion of abandoned groups and their projects](#deletion_groups)
- [More precise details](#deletion_details)
- [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.
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.
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 in the [IT service centre of the Justus Liebig University (JLU) Giessen](https://www.uni-giessen.de/fbz/svc/hrz){: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){:target="_blank"}.
JLU GitLab is maintained by a [team of voluntary employees](#maintainers).
* 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.
* TODO: Add more: lab management, writing and publishing, ...
## No storage of research data {#research_data}
JLU GitLab is currently not suited to store research data.
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 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).
## Who may use JLU GitLab? {#potential_users}
Currently nobody; first, the [terms of service]({{ '/terms-of-service/' | relative_url }}) must be written.
Once this is done, any student or employee with a valid s- oder g-Login may open a user account, as long as they accept the terms of service.
This means that *internal* visibility of [projects]({{ '/help/#project_visibility' | relative_url }}) or [groups]({{ '/help/#group_visibility' | relative_url }}) is applied to all of these people.
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.
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"}.
## How can I use JLU GitLab? {#how_to_use}
You can find information on the practical use of JLU GitLab at [help on use]({{ '/help/' | relative_url }}).
Accounts of JLU GitLab may be terminated in multiple ways:
- Users may voluntarily delete their account at any time.
If you want to delete your account, please [follow these steps]({{ '/help/#deletion_account' | relative_url }}).
You may also consider some [last steps]({{ '/help/#last_steps' | relative_url }}) before you delete your account.
- The account will be deleted after 6 months after your [g- or s- account becomes invalid](#deletion_account_invalid), which most commonly happens if you [leave the university](#leaving_JLU).
- The [maintainers](#maintainers) may delete a user account if its activities violate the [terms of service]({{ '/terms-of-service/' | relative_url }}).
Below you find an [overview what data will also be deleted](#deletion_userdata) when your account gets deleted.
### 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.
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.
### What happens if my g- or s-account becomes invalid? {#deletion_account_invalid}
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.
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}
How much of your data will be deleted depends on how you used JLU GitLab before your account was deleted.
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.
Further below, you find [more precise details](#deletion_details).
#### Deletion of abandoned groups and their projects {#deletion_groups}
In case you are the only *Owner* of a group at the time of deletion, the group members with the next highest [group role]({{ '/help/#group_roles' | relative_url }}) will be promoted to the *Owner* role and notified about it.
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}
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*.
Note that these projects will be deleted unconditionally, even if they have other project members.
You may take some [last steps]({{ '/help/#last_steps' | relative_url }}) to avoid possible disruptions.
Data that you contributed to other projects (in namespaces of other users or groups) will not be deleted ([unless a group becomes abandoned](#deletion_groups)).
Instead, your contributions will be anonymized as much as is technically possible and acceptable for the remaining members.
This prevents disruption of the remaining members, whose work builds upon your contributions.
For example, the content of your comments in issue trackers of other projects will remain visible, just without a link to your deleted account.
Instead, your comments will appear to be written by a *Ghost* account, which is a placeholder account to manage such anonymized data.
An important exception are your Git *commits* in *repositories* of other projects: They will neither be deleted nor anonymized.
Instead, all information that were used to create the commit will remain as they were; they cannot be altered or deleted without causing disruption for the remaining members.
Also note that your commit data are probably not only saved on JLU GitLab but also on the devices of fellow members, because the Git commands *push* and *pull* can synchronize the entire repository across devices.
JLU GitLab will not (and neither can) delete data from other user's devices.
Importantly, commits may include your real name and email address, depending on the settings of your own device and JLU GitLab.
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}
We are a team of JLU employees who volunteer to provide the JLU GitLab pilot service.
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 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.
You can contact us in various ways, see the [contact information](#contact).
## The goals of JLU GitLab {#our_goals}
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.
Only a locally installed, freely licensed platform like GitLab can ensure our long-term control over its implementation and administration.
<!-- NOTE: Delete, or move to data section and clarify?
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).
Once JLU GitLab is usable within the university, we have further plans to make it even more useful.
- ...make JLU GitLab accessible directly from the Internet, without VPN
- ...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"}
- ...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"}
## 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 anything else, can contact the [team of maintainers](#maintainers) at our internal mailing list at [gitlab-admin@lists.uni-giessen.de](mailto:gitlab-admin@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 }}).
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).