zukunftsloesungen-ejournal/README.md

# Zukunftslösungen - Ein eJournal zur Weltverbesserung

# Themensammlung

Kapitelvorschläge: 
1. [Größe und Struktur Git Repo](#groesse-und-struktur) 
2. [Wofür Git?](#git-wofuer) **Eiscafé / Fonduestube**
3. [Wie geht das mit Webhook und Matrix?](#webhook) 
4. [Gesamtstruktur von Git](#struktur) **Gartenterasse**
5. [Interagieren auf den verschiedenen Ebenen](#interaktion-in-git) 
6. [Wie lässt sich Git mit anderen Apps verknüpfen?](#gitundapps) 
7. [Welche Interaktion gibt mit anderen CI Tools?](#interaktion-ci-tools)
8. [Vereinbarung mit Working out loud](#workingoutloud) 
9. [Anwendungsfälle git für OER](#anwendungsfaelle)
10. [Auffindbarkeit OER in git](#auffindbarkeit) **Gruppenarbeit 1**
11. [Wie erstellen wir #OER mit git?](#oer-erstellen)


Hier hat Johann Amos Comenius ein Repositorium angelegt, in dem wir arbeiten können:
https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal


## Kapitel / Inhalte / Fragestellungen

<a id="groesse-und-struktur"></a>
### 1. Welche sinnvolle Größe und Struktur sollte ein Git-Repositorium  haben? Welche Dateien sind essentiell?
- Was sind geeignete Formate und Pakete um diese mit anderen zu bearbeiten und sie gut forken zu können?
- Wie hält man ein Repositorium übersichtlich?
- Was muss in der Readme.md stehen?
- Wie sollte man beim Anlegen eines Repositorium vorgehen? 
- Wozu braucht es einen Kontrakt für die Mitarbeit?
- Wann sollte man einen neuen Branch erzeugen?

<a id="#git-wofuer"></a>
### 2. Wofür überhaupt Git - nur eine neue digitale Sau?

- Welchen Nutzen hat Git? Was löst Git, was über andere technische Lösungen weniger gut zu gewährleisten ist?
- Welche Herausforderungen zeigen sich?
- Ist Git für alle Anwendungsbereiche im Institut sinnvoll einsetzbar? Bzw. für welche kann es sinnvoll sein, für welche weniger?
- Wollen wir git für das Abarbeiten von Aufgaben nehmen?
- Wie soll sich Git in der Toolbox des CI zu anderen Werkzeugen verhalten (Etherpads, Nextcloud und OnlyOffice, "alte" Kanban-Boards, XWiki ...)? Soll git z. B. das Nextcloud Deck ablösen?
- Wenn wir in git Verweise zu Nextcloud oder XWiki unterbringen, dann können Dritte diese Verweise nicht nutzen. Für unsere Zusammenarbeit in Git werden solche Verweise aber unvermeidlich sein.
- 

<a id="webhook"></a>
### 3. Wie geht das mit dem Webhook und der Matrix?
- Die Anleitung zur Integration in die Matrix ist [hier gut dokumentiert](https://docs.codeberg.org/integrations/matrix/) 
- Wir haben das exemplarisch für unser git mit Gitta Forker als Bot hier in der Matrix einmal eingerichtet
- Nun gilt es die Einrichtung als Anleitung zu dokumentieren und nachvollziehbar zu machen. 
    - Auch der Zugangskey für den "Gitta-Bot" sollte irgendwo datensicher abgelegt werden und für Comenius-Institutsmitarbeitende zugänglich gemacht werden 


<a id="struktur"></a>
### 4. Wie ist die Gesamtstruktur von git?

- Git arbeitet mit vielen Begriffen und Logiken, die ITlern vertraut, anderen aber oft fremd sind. Hier ist voraussichtlich ein hoher Übersetzungsaufwand nötig.
- Welche Prozesse der Zusammenarbeit sollen in git verfolgt werden?
- Wie kommen wir von einer Software zur Verwaltung von Dateiversionen zu einem Tool, das Arbeitsprozesse in einer Organisation erleichtert?

<a id="interaktion-in-git"></a>
### 5. Wie interagieren die verschiedenen Ebenen und Formate innerhalb von git? (issues, Projekte, repositorien,...)

<a id="gitundapps"></a>
### 6. Wie lässt sich Git mit anderen technischen Applikationen verknüpfen? 
- Gibt es Verknüpfungen auch zu proprietären Sozialen Medien / Plattformen? / Wie hilft uns Git in Bezug auf FOERBICO in der Schnittstelle zu wirlernenonline u.ä.?
- '''

<a id="interaktion-ci-tools"></a>
### 7. Welche Interaktion gibt mit anderen CI Tools?
- cloud, element, wordpress, pads,... (siehe auch "Wofür überhaupt Git?")
- Hier geht es nicht nur um eine technische Frage, sondern auch darum, für welchen Zweck und wie diese unterschiedlichen Instrumente jeweils eingesetzt werden. Zentrales Kriterium sollte u.a. wenig Überschneidung der Instrumente sein - d.h. es muss immer eindeutig klärbar sein, wenn ein Anwendungsfall vorliegt, welches Instrument dafür das geeignete ist.  
- Wie kann git mit andren (externen) Partnern genutzt werden? Was gilt es ggf. zu beachten (Stichwort Datenschutz, etc.?)
- Die Langzeitspeicherung kann git recht gut hinbekommen. 


<a id="workingoutloud"></a>
### 8. Vereinbarung für Working out loud.
- Offene und zugleich prozessorientierte Kommunikation?
- Wie schaffen wir es, nicht auf zu vielen Plattformen zu kommunizieren?
- Welche Voraussetzungen braucht es für eine gelingende asynchrone und synchrone Kommunikation?
- Arbeit [hier im Issue](https://git.rpi-virtuell.de/Comenius-Institut/fOERbico/issues/33)

<a id="anwendungsfaelle"></a>
### 9. Wie sehen Anwendungsfälle für die Nutzung von Git für OER aus?
- Beispiele für einen "proof of concept" haben wir in unserem git z.B.
    - [hier in unserem git mit der "Du-Ermutigung"](https://git.rpi-virtuell.de/Comenius-Institut/du-ermutigung) erstellt
    - hier mit einem gespiegelten github-Repositorium mit dem

<a id="auffindbarkeit"></a>
### 10. Wie machen wir Wissen (z.b. zu OER) auffindbar in git? Soll es das überhaupt leisten?

- Gibt es innerhalb von markdown / git sozusagen Verweise / Links von einer zur anderen Stelle?
- wie finden das Dritte aus den communities, die eigentlich gar nicht mit git unterwegs sind?

<a id="oer-erstellen"></a>
### 11. Wie erstellen wir "#OER" mit git und wie wird es gefunden und daran weitergearbeitet?