From 9d601094855df854f6887268b06ca0fc065f2699 Mon Sep 17 00:00:00 2001 From: Johannes Keyser <johannes.keyser@sport.uni-giessen.de> Date: Thu, 25 Feb 2021 13:14:03 +0100 Subject: [PATCH] Some cleanups, formatting, adding links, etc. --- de/Informationen.md | 35 ++++++++++++++++++++--------------- en/Information.md | 36 ++++++++++++++++++++---------------- 2 files changed, 40 insertions(+), 31 deletions(-) diff --git a/de/Informationen.md b/de/Informationen.md index 11b2d08..19e3033 100644 --- a/de/Informationen.md +++ b/de/Informationen.md @@ -23,19 +23,27 @@ JLU GitLab wird von einem [Team freiwilliger Mitarbeitenden](#wer-betreibt-jlu-g ## Speicherung von Forschungsdaten JLU GitLab kann für die Versionierung und Verwaltung von Sourcecode und durch diesen Code zu generierende bzw. zu analysierende Forschungsdaten verwendet werden. Um JLU GitLab die Verwaltung von Forschungsdaten in ihrem Repositorium zu ermöglichen, müssen Sie [Git LFS konfigurieren](https://gitlab.test.uni-giessen.de/jlugitlab/git-lfs-howto). -Sollten Sie Forschungsdaten zusammen mit Sourcecode in GitLab verwalten wollen, so sind folgende Einschränkungen zu berücksichtigen: -- GitLab ist für die Speicherung von Daten mit **[normalem Schutzbedarf geeignet](https://gitlab.test.uni-giessen.de/jlugitlab/support/-/blob/master/de/Nutzungsbedingungen.md#datensicherheit)**. Das bedeutet, dass die **Schadensauswirkungen** bei **Verlust der Integrität** und/oder **Verfügbarkeit** und/oder **Vertraulichkeit** der in GitLab abgelegten Daten für Sie und andere **begrenzt und überschaubar** sein sollten. -Als grobe Faustregel zum Datenschutz gilt, personenbezogene Daten, die nicht in die besonderen Kategorien nach DSGVO fallen (Gesundheitsdaten, religöse/weltanschauliche Überzeugungen, sexuelle Orientierung u.w.) fallen unter normalen Schutzbedarf. ->**Hinweis: Dieser Text ersetzt keine rechtliche Beratung im Umgang mit personenbezogenen Daten**. ->Wir empfehlen ihnen ggf. eine Schutzbedarfsfeststellung durchzuführen. ->Bei Fragen zum Datenschutz, wenden Sie sich bitte an die [Datenschutzbeauftragten der JLU](https://www.uni-giessen.de/org/admin/dez/b/1/Datenschutz/Datenschutzbeauftragter). +Sollten Sie Forschungsdaten zusammen mit Quellcode in GitLab verwalten wollen, so sind folgende Einschränkungen zu berücksichtigen: +- GitLab ist für die Speicherung von Daten mit **[normalem Schutzbedarf geeignet](Nutzungsbedingungen.md#datensicherheit)**. + Das bedeutet, dass die **Schadensauswirkungen** bei **Verlust der Integrität** und/oder **Verfügbarkeit** und/oder **Vertraulichkeit** der in GitLab abgelegten Daten für Sie und andere **begrenzt und überschaubar** sein sollten. +Als grobe Faustregel zum Datenschutz gilt, personenbezogene Daten, die **nicht** in die besonderen Kategorien nach DSGVO fallen (Gesundheitsdaten, religöse/weltanschauliche Überzeugungen, sexuelle Orientierung u.w.) fallen unter normalen Schutzbedarf. -- Sollten Sie spezielle Anforderungen an die Ablage der Forschungsdaten haben, diese aber dennoch mit dem Code in GitLab verknüpfen wollen, so besteht die Möglichkeit, dass Sie Git LFS auf einem eigenen Server betreiben. -- **GitLab ist nicht als Archiv oder Netzlaufwerk geeignet**. Sollten Sie für ihre Arbeitsgruppe ein Datenarchiv benötigen, nutzen Sie das [Angebot des HRZ](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html). -- **GitLab ist nicht als Sync&Share Dienst geeignet**. Sollten Sie eine Sync&Share-Lösung benötigen, nutzen Sie bitte die [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox). -- **GitLab ist keine Publikationsplatform für Forschungsdaten**. Sollten Sie ihre Forschungsdaten publizieren wollen, können Sie dafür [JLUdata](https://jlupub.ub.uni-giessen.de/handle/jlupub/1) nutzen. +> **Hinweis: Dieser Text ersetzt keine rechtliche Beratung im Umgang mit personenbezogenen Daten**. +> Wir empfehlen ihnen ggf. eine Schutzbedarfsfeststellung durchzuführen. +> Bei Fragen zum Datenschutz, wenden Sie sich bitte an die [Datenschutzbeauftragten der JLU](https://www.uni-giessen.de/org/admin/dez/b/1/Datenschutz/Datenschutzbeauftragter). -Zum Umgang mit Forschungsdaten an der JLU beachten Sie bitte auch die [Forschungsdaten-Leitlinie](https://www.uni-giessen.de/mug/5/pdf/forschung/5_00_00_1). Eine [Übersicht](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/fragen#anker-daten-speichern-arbeitsprozess) der an der JLU vorhandenen Dienste für den Umgang mit Forschungsdaten finden Sie beim [Referat für Forschungsdaten](https://www.uni-giessen.de/ub/digitales-publizieren/fdm). Bei weiteren Fragen des Forschungsdatenmanagements hilft Ihnen [dieser FAQ](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/faq/) weiter. Bei allen Fragen, rund um das Forschungsdatenmanagement, hilft ihnen das Referat für Forschungsdaten gerne weiter ([forschungsdaten@uni-giessen.de](mailto:forschungsdaten@uni-giessen.de)). +- Sollten Sie spezielle Anforderungen an die Ablage der Forschungsdaten haben, diese aber dennoch mit dem Code in GitLab verknüpfen wollen, so besteht die Möglichkeit, dass Sie Git LFS auf einem eigenen Server betreiben. +- **GitLab ist nicht als Archiv oder Netzlaufwerk geeignet**. + Sollten Sie für ihre Arbeitsgruppe ein Datenarchiv benötigen, nutzen Sie das [Angebot des HRZ](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html). +- **GitLab ist nicht als Sync&Share Dienst geeignet**. + Sollten Sie eine Sync&Share-Lösung benötigen, nutzen Sie bitte die [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox). +- **GitLab ist keine Publikationsplatform für Forschungsdaten**. + Sollten Sie ihre Forschungsdaten publizieren wollen, können Sie dafür [JLUdata](https://jlupub.ub.uni-giessen.de/handle/jlupub/1) nutzen. + +Zum Umgang mit Forschungsdaten an der JLU beachten Sie bitte auch die [Forschungsdaten-Leitlinie](https://www.uni-giessen.de/mug/5/pdf/forschung/5_00_00_1). +Eine [Übersicht](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/fragen#anker-daten-speichern-arbeitsprozess) der an der JLU vorhandenen Dienste für den Umgang mit Forschungsdaten finden Sie beim [Referat für Forschungsdaten](https://www.uni-giessen.de/ub/digitales-publizieren/fdm). +Bei weiteren Fragen des Forschungsdatenmanagements hilft Ihnen [dieser FAQ](https://www.uni-giessen.de/ub/digitales-publizieren/fdm/faq/) weiter. +Bei allen Fragen, rund um das Forschungsdatenmanagement, hilft ihnen das Referat für Forschungsdaten gerne weiter ([forschungsdaten@uni-giessen.de](mailto:forschungsdaten@uni-giessen.de)). ## Wer kann auf JLU GitLab zugreifen? @@ -132,17 +140,14 @@ Wir sind auf verschiedene Weisen erreichbar, siehe [Kontaktinformation](#Kontakt Der Testbetrieb von 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. Nur eine lokal installierte, frei lizensierte Plattform wie GitLab kann langfristig sicherstellen, unsere Kontrolle über dessen Implementation und Administration zu wahren. -<!-- NOTE: Löschen, oder zu FDM hinzugefügen und klären? -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 Nachdem JLU GitLab universitätsintern nutzbar ist, haben wir weitere Pläne um es noch nützlicher zu machen. Wir würden gerne... -- ...die Verwendung von [Git Large File Storage (LFS)](https://docs.gitlab.com/ce/workflow/lfs/manage_large_binaries_with_git_lfs.html) erörtern - ...der Möglichkeit nachgehen wie Inhalte per [GitLab Pages](https://docs.gitlab.com/ce/user/project/pages/) publiziert werden können +- ...evaluieren ob wir Instanz-weite Runner für CI/CD zur Verfügung stellen ## Kontakt diff --git a/en/Information.md b/en/Information.md index e5fdfb0..d2b928e 100644 --- a/en/Information.md +++ b/en/Information.md @@ -21,23 +21,30 @@ JLU GitLab is maintained by a [team of voluntary employees](#who-is-maintaining- * TODO: Add more: lab management, writing and publishing, ... ## Storage of research data -JLU GitLab can be used for versioning and managing source code and research data -that is to be generated or analyzed by that code. To enable JLU GitLab to manage research data in its repository, you must configure Git LFS. +JLU GitLab can be used for versioning and managing source code and research data that is to be generated or analyzed by that code. +To enable JLU GitLab to manage research data in its repository, you must [configure Git LFS](https://gitlab.test.uni-giessen.de/jlugitlab/git-lfs-howto). Should you wish to manage research data along with source code in GitLab, the following limitations must be considered: -- GitLab is suitable for storing data with **[regular protection requirements](https://gitlab.test.uni-giessen.de/jlugitlab/support/-/blob/master/en/TermsOfUse.md#data-security)**. This means that if the **integrity** and/or **availability** and/or **confidentiality** of data stored in GitLab is lost, the damage impact to you and others **should be limited and manageable**. -As a rough rule of thumb for data protection, personal data that do not fall into the special categories according to DSGVO (health data, religious/ideological beliefs, sexual orientation, etc.) fall under normal protection needs. ->**Note: This text does not replace legal advice on handling personal data.** ->We recommend that you carry out a protection needs assessment if necessary. ->If you have any questions regarding data protection, please contact the [data protection officers at JLU](https://www.uni-giessen.de/org/admin/dez/b/1/Datenschutz/Datenschutzbeauftragter). +- GitLab is suitable for storing data with **[regular protection requirements](TermsOfUse.md#data-security)**. + This means that if the **integrity** and/or **availability** and/or **confidentiality** of data stored in GitLab is lost, the damage impact to you and others **should be limited and manageable**. + As a rough rule of thumb for data protection, personal data that do **not** fall into the special categories according to DSGVO (health data, religious/ideological beliefs, sexual orientation, etc.) fall under normal protection needs. -- If you have special requirements for storing research data, but still want to link it to the code in GitLab, you have the option of running Git LFS on your own server. -- **GitLab is not suitable as an archive or network drive**. If you need a data archive for your workgroup, use what the [HRZ offers](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html). -- **GitLab is not suitable as a Sync&Share service**. If you need a sync&share solution, please use the [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox). -- **GitLab is not a publication platform for research data**. If you want to publish your research data, you can use [JLUdata](https://jlupub.ub.uni-giessen.de/handle/jlupub/1) for this purpose. +> **Note: This text does not replace legal advice on handling personal data.** +> We recommend that you carry out a protection needs assessment if necessary. +> If you have any questions regarding data protection, please contact the [data protection officers at JLU](https://www.uni-giessen.de/org/admin/dez/b/1/Datenschutz/Datenschutzbeauftragter). -Regarding the handling of research data at JLU, please also refer to the Research Data Guideline. An overview of the services available at JLU for handling research data can be found at the Department for Research Data. If you have further questions about research data management, this FAQ will help you. You can reach the Research Data Unit by e-mail at forschungsdaten@uni-giessen.de. +- If you have special requirements for storing research data, but still want to link it to code in GitLab, you have the option of running Git LFS on your own server. +- **GitLab is not suitable as an archive or network drive**. + If you need a data archive for your workgroup, use what the [HRZ offers](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/san/index_html). +- **GitLab is not suitable as a Sync&Share service**. + If you need a sync&share solution, please use the [JLUbox](https://www.uni-giessen.de/fbz/svc/hrz/svc/daten/jlubox). +- **GitLab is not a publication platform for research data**. + If you want to publish your research data, you can use [JLUdata](https://jlupub.ub.uni-giessen.de/handle/jlupub/1) for this purpose. +Regarding the handling of research data at JLU, please also refer to the Research Data Guideline. +An overview of the services available at JLU for handling research data can be found at the Department for Research Data. +If you have further questions about research data management, this FAQ will help you. +You can reach the Research Data Unit by e-mail at forschungsdaten@uni-giessen.de. ## Who can access JLU GitLab? @@ -132,9 +139,6 @@ You can contact us in various ways, see the [contact information](#contact). JLU GitLab first serves to assess demands across JLU and to evaluate its features in a research context. We believe that currently, Git and GitLab provide the best tools to manage the software for our research projects and to document them. 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). ---> ## Future plans @@ -142,7 +146,7 @@ Once JLU GitLab is usable within the university, we have further plans to make i We would like to... - ...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) +- ...evaluate the addition instance-wide of runners for CI/CD ## Contact -- GitLab