add-auffindbarkeit

Dies ist eine Aktualisierung durch die AG 2 / Projekttag

Nutzen von Git.md

@@ -0,0 +1,29 @@
+# 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?  
+
+Hier scheinen sich drei Anwendungsfelder anzubieten:
+
+### I. 
+OER anlegen aus zwei Gründen: 1. Möglichkeit zum Forken; einfaches Implementieren in andere Plattformen wg. Markdown
+
+### II. 
+Dokumente veröffentlichen, die offentlich weiter entwickelt werden können und dafür als Versionen erscheinen sollen ( Beispiel Handbuch Grundbildung )
+
+### III. 
+Projektmanagement, wenn unterschiedliche Kooperationspartner zusammenarbeiten.
+
+## Welche Herausforderungen zeigen sich?
+- Hohe Lernanforderung und Sprache
+- Fachbegriffe, in die man sich einarbeiten muss. 
+
+## Ist Git für alle Anwendungsbereiche im Institut sinnvoll einsetzbar? Bzw. für welche kann es sinnvoll sein, für welche weniger?
+Für das kollaborative Entwickeln von Texten (auch CI-Inforamtionen) ist es (nach Meinung der AG 2 während des Projekttages) weniger sinnvoll.
+
+## Weitere Frage
+- 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.
+- Hier gibt es auch [einen Issue dazu](https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal/issues/2)
+
+# Was löst Git, was über andere technische Lösungen weniger gut zu gewährleisten ist?

README.md

@@ -1,6 +1,4 @@
-# zukunftsloesungen-ejournal
-
-Zukunftslösungen - Ein eJournal zur Weltverbesserung
+# Zukunftslösungen - Ein eJournal zur Weltverbesserung
 
 # Themensammlung
 
@@ -9,11 +7,13 @@ Kapitelvorschläge:
 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) 
-6. [Wie lässt sich Git mit anderen Apps verknüpfen](#gitundapps) 
-7. [Vereinbarung mit Working out loud](#workingoutloud) 
-8. [Anwendungsfälle git für OER](#anwendungsfaelle)
-9. [Auffindbarkeit OER in git](#auffindbarkeit)  **Gruppenarbeit 1**
+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:
@@ -23,7 +23,7 @@ https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal
 ## Kapitel / Inhalte / Fragestellungen
 
 <a id="groesse-und-struktur"></a>
-### Welche sinnvolle Größe und Struktur sollte ein Git-Repositorium  haben? Welche Dateien sind essentiell?
+### 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?
@@ -32,18 +32,28 @@ https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal
 - Wann sollte man einen neuen Branch erzeugen?
 
 <a id="#git-wofuer"></a>
-### Wofür überhaupt Git - nur eine neue digitale Sau?
+### 2. Wofür überhaupt Git - nur eine neue digitale Sau?
+Vgl. auch das Kapitel (https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal/src/branch/main/Nutzen%20von%20Git.md)
 
-- 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?
+#### Welchen Nutzen hat Git? Was löst Git, was über andere technische Lösungen weniger gut zu gewährleisten ist?  
+Hier scheinen sich drei Anwendungsfelder anzubieten:
+I. OER anlegen aus zwei Gründen: 1. Möglichkeit zum Forken; einfaches Implementieren in andere Plattformen wg. Markdown
+II. Dokumente veröffentlichen, die offentlich weiter entwickelt werden können und dafür als Versionen erscheinen sollen ( Beispiel Handbuch Grundbildung )
+III. Projektmanagement, wenn unterschiedliche Kooperationspartner zusammenarbeiten.
+
+#### Welche Herausforderungen zeigen sich?
+- Hohe Lernanforderung und Sprache
+- Fachbegriffe, in die man sich einarbeiten muss. 
+#### Ist Git für alle Anwendungsbereiche im Institut sinnvoll einsetzbar? Bzw. für welche kann es sinnvoll sein, für welche weniger?
+Für das kollaborative Entwickeln von Texten (auch CI-Inforamtionen) ist es (nach Meinung der AG 2 während des Projekttages) weniger sinnvoll.
+#### Weitere Frage
 - 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.
-- 
+- Hier gibt es auch [einen Issue dazu](https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal/issues/2)
 
 <a id="webhook"></a>
-### Wie geht das mit dem Webhook und der Matrix?
+### 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. 
@@ -51,23 +61,22 @@ https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal
 
 
 <a id="struktur"></a>
-### Wie ist die Gesamtstruktur von git?
+### 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"></a>
-### wie interagieren die verschiedenen Ebenen und Formate innerhalb von git? (issues, Projekte, repositorien,...)
+<a id="interaktion-in-git"></a>
+### 5. Wie interagieren die verschiedenen Ebenen und Formate innerhalb von git? (issues, Projekte, repositorien,...)
 
 <a id="gitundapps"></a>
-### Wie lässt sich Git mit anderen technischen Applikationen verknüpfen? 
-
+### 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.ä.?
 - '''
 
-### Welche Interaktion gibt mit anderen CI Tools?
-
+<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.?)
@@ -75,23 +84,24 @@ https://git.rpi-virtuell.de/Comenius-Institut/zukunftsloesungen-ejournal
 
 
 <a id="workingoutloud"></a>
-### Vereinbarung für Working out loud.
+### 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?
-
-### Wie sehen Anwendungsfälle für die Nutzung von Git für OER aus?
+- 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
 
-### Wie erstellen wir "#OER" mit git und wie wird es gefunden und daran weitergearbeitet?
-
-
 <a id="auffindbarkeit"></a>
-### Wie machen wir Wissen (z.b. zu OER) auffindbar in git? Soll es das überhaupt leisten?
+### 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?
+- [Hier wurde ein Issue dazu erstellt](https://git.rpi-virtuell.de/Comenius-Institut/git/issues/49)
+
+<a id="oer-erstellen"></a>
+### 11. Wie erstellen wir "#OER" mit git und wie wird es gefunden und daran weitergearbeitet?