Handreichung-Dateneingabe.md

@@ -7,4 +7,73 @@
 
 # Datensatz
 
-Der Datensatz bildet das institutionelle Open-Access-Engagement der einzelnen wissenschaftlichen Einrichtungen ab. Viele der Informationen liegen durch Berichtspflichten sowie interne Workflows und Prozesse schon verteilt vor und werden mit Hilfe des Index erstmal an einer Stelle zusammengeführt. 
+Der Datensatz bildet das institutionelle Open-Access-Engagement der einzelnen wissenschaftlichen Einrichtungen ab. Viele der Informationen liegen durch Berichtspflichten sowie interne Workflows und Prozesse schon verteilt vor und werden mit Hilfe des Index erstmals an einer Stelle zusammengeführt. Damit kann er auch für die beitragenden Einrichtungen wiederum für interne Abläufe genutzt werden.
+
+Im Sinne der Sichtbarkeit und Nachnutzung wird der Datensatz über GitLab verfügbar gemacht. 
+
+
+# Datenschema
+
+Jeder Indikator bildet eine Spalte, und pro Einrichtung wird eine Zeile verwendet.
+
+Eine Übersicht des Transformations-Datenschemas ist [hier](https://gitlab.ub.uni-bielefeld.de/oa2020-de/transformationsindex/wikis/schema) zu finden. Dieser Beitrag der Universität ... ist ein gutes Beispiel für eine Schema-konforme Einreichung.
+
+
+# Einreichung
+
+Ihre CSV-Dateien können sie dem Transformationsindex-Projekt auf 2 Arten zur Verfügung stellen:
+
+* Per Mail an alexandra.jobmann@uni-bielefeld.de
+* Per Pull Request direkt auf GitLab. Dieser Vorgang wird im Folgenden genauer erläutert.
+
+## GitLab-Workflow: Hinzufügen einer neuen Institution
+
+Um Daten erstmalig für eine Institution hinzuzufügen, sind die folgenden Schritte nötig:
+
+* Registrierung auf GitLab (kostenfrei) - der Nutzername sei im Folgenden als YOURUsername bezeichnet
+* Einen Fork des Original-Transformationsindex-Repositorys unter ihrem Benutzerkonto erstellen
+* Lokale Kopie (clone) des Forks auf ihrem Rechner anlegen
+* Neuen Ordner für die Institution im Verzeichnis data anlegen
+* Dateien in diesem Ordner ablegen
+* Kopie des lokal veränderten Repository auf GitLab veröffentlichen
+* per Pull Request die Aufnahme in die Datensammlung des OA2020-DE-Transformationsindex beantragen
+
+Nach der Registrierung und dem Fork führen sie die Schritte 3-6 auf ihrem lokalen Rechner folgendermaßen durch:
+
+Erstellen einer lokale Kopie:
+
+`$ git clone git@gitlab.ub.uni-bielefeld.de:oa2020-de/transformationsindex.git`
+
+Neuen Ordner für ihre Institution hinzufügen:
+
+```
+$ cd oa2020-de/transformationsindex/data
+$ mkdir YOURfolder
+```
+
+Die csv-Tabelle(n) in den Ordner YOURfolder kopieren:
+
+`$ cp YOURdata.csv oa2020-de/transformationsindex/data/YOURfolder`
+
+Add/Commit durchführen und in GitLab hochladen:
+
+```
+$ git add oa2020-de/transformationsindex/data/YOURfolder/
+$ git commit -m "open access engagement of my institution in 2017"
+$ git push origin master
+```
+
+Um die Dateien im letzten Schritt 7 in das Transformationsindex-Ausgangsrepository hinzuzufügen, muss ein Pull Request gestellt werden.
+
+
+## GitLab-Workflow: Aktualisieren Ihrer Daten
+
+Um bereits existierende Daten einer Institution zu aktualisieren bzw. zu ergänzen, sind die folgenden Schritte nötig:
+
+* Lokales Repository auf den aktuellen Stand des Transformationsindex-Repository bringen (Details dazu hier)
+* Daten im Ordner der eigenen Institution verändern
+* Kopie des lokal veränderten Repository auf GitLab veröffentlichen
+* per Pull Request die Aufnahme in die Datensammlung des OA2020-DE-Transformationsindex beantragen
+
+
+