Links kürzen

This commit is contained in:
Ludger Sicking 2025-05-09 17:41:24 +02:00
parent 33e9606a28
commit 572825d1ab

View file

@ -76,7 +76,7 @@ Wir nutzen konsequent eine offene, git-basierte Infrastruktur zur Organisation d
Im FOERBICO-Projekt setzen wir auf Git als zentrales Werkzeug für Versionsverwaltung und Kollaboration. Unsere Projektmaterialien liegen in einem Git-Repository auf der Plattform [**git.rpi-virtuell**](https://git.rpi-virtuell.de/) ([Forgejo](https://forgejo.org/)-basiert). [Dieses Hauptrepository](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO) enthält den gesamten Quelltext der Projekt-Website sowie begleitende Dokumentation und Bildungsinhalte. Der Repository-Titel sowie die Beschreibung machen unseren Projektauftrag direkt ersichtlich. Mit derzeit 16 Branches und über 600 Commits (Stand: April 2025) zeigt sich zunehmend eine rege Entwicklungs- und Redaktionstätigkeit. Die Nutzung von Git ermöglicht uns, **Änderungen an Dateien nachzuverfolgen**, frühere Versionen wiederherzustellen und parallel an verschiedenen Inhalten zu arbeiten, ohne Datenverlust oder Konflikte.
**Struktur des Repositories:** Wir haben im Repository eine klare Ordnerstruktur etabliert, welche technische Komponenten und redaktionelle Inhalte trennt. Beispielsweise liegen Quellcode und Design der Website im Ordner `Website/` und `design/`, während Anleitungen, Präsentationen sowie Lehr- und Lernmaterialien im in Markdown-Dateien in sich entwickelnden Verzeichnisstrukturen abgelegt sind. Zusätzliche Verzeichnisse wie `assets/` dienen der Ablage von Bildern und Medien. Außerdem existiert ein Verzeichnis `archiv/`, in dem wir projektbezogene Berichte und archivierte Dokumente versioniert ablegen (z.B. Projektzwischenberichte als Markdown). Zentrale Übersichts- und Planungsdokumente sind als Markdown-Dateien vorhanden, darunter `README.md` (Einstiegsinformationen), `Ziele.md` (Projektziele), `Meilensteine.md` (Übersicht der Arbeitspakete). So ist es beispielsweise möglich, dass wir [ein sich aktualisierendes Gantt-Chart der Projektplanung hier interaktiv](https://projekt.oer.community/gantt/) direkt mit den Meilensteinen und zugeordneten Aufgaben erschließbar machen können. Aus der Datei `FOERBICO-Workflow.drawio` lässt sich kooperativ und versionierbar [hier ein Diagramm unserer internen Arbeitsabläufe](https://app.diagrams.net/?src=about#Uhttps%3A%2F%2Fgit.rpi-virtuell.de%2FComenius-Institut%2FFOERBICO%2Fraw%2Fbranch%2Fmain%2FFOERBICO-Workflow.drawio#%7B%22pageId%22%3A%22Ht1M8jgEwFfnCIfOTk4-%22%7D) transparent entwickeln. Durch diese offene Dokumentation direkt im Repository sind alle Teammitglieder stets auf demselben Stand bezüglich Zielsetzungen, Zeitplanung und Verantwortlichkeiten.
**Struktur des Repositories:** Wir haben im Repository eine klare Ordnerstruktur etabliert, welche technische Komponenten und redaktionelle Inhalte trennt. Beispielsweise liegen Quellcode und Design der Website im Ordner `Website/` und `design/`, während Anleitungen, Präsentationen sowie Lehr- und Lernmaterialien im in Markdown-Dateien in sich entwickelnden Verzeichnisstrukturen abgelegt sind. Zusätzliche Verzeichnisse wie `assets/` dienen der Ablage von Bildern und Medien. Außerdem existiert ein Verzeichnis `archiv/`, in dem wir projektbezogene Berichte und archivierte Dokumente versioniert ablegen (z.B. Projektzwischenberichte als Markdown). Zentrale Übersichts- und Planungsdokumente sind als Markdown-Dateien vorhanden, darunter `README.md` (Einstiegsinformationen), `Ziele.md` (Projektziele), `Meilensteine.md` (Übersicht der Arbeitspakete). So ist es beispielsweise möglich, dass wir [ein sich aktualisierendes Gantt-Chart der Projektplanung hier interaktiv](https://projekt.oer.community/gantt/) direkt mit den Meilensteinen und zugeordneten Aufgaben erschließbar machen können. Aus der Datei `FOERBICO-Workflow.drawio` lässt sich kooperativ und versionierbar [hier ein Diagramm unserer internen Arbeitsabläufe](https://app.diagrams.net/?src=about#Uhttps%3A%2F%2Fgit.rpi-virtuell.de%2FComenius-Institut%2FFOERBICO%2Fraw%2Fbranch%2Fmain%2FFOERBICO-Workflow.drawio) transparent entwickeln. Durch diese offene Dokumentation direkt im Repository sind alle Teammitglieder stets auf demselben Stand bezüglich Zielsetzungen, Zeitplanung und Verantwortlichkeiten.
**Offene Lizenzierung:** Sämtliche Inhalte im Repository unterliegen offenen Lizenzen. Wir verwenden vornehmlich die [*Creative Commons BY 4.0*](https://creativecommons.org/licenses/by/4.0/deed.de)-Lizenz, wie in unseren [Mitwirkungsrichtlinien](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/src/branch/main/contributing.md) festgehalten. Das bedeutet, dass alle neu erstellten oder bearbeiteten Materialien von uns offen nachnutzbar sind, sofern Urheberschaft genannt wird. Diese Lizenz ist im Repository durch die Datei [`LICENSE`](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/src/branch/main/LICENSE) und entsprechende Hinweise in den Beitragsrichtlinien verankert. Damit stellen wir sicher, dass nicht nur unsere Prozesse offen sind, sondern auch die entstehenden Bildungsressourcen frei verwendet werden dürfen ein Kernprinzip von Open Educational Resources.
@ -129,7 +129,7 @@ Zusammenfassend garantiert der Git-Workflow mit Feature-Branches, Reviews und CI
Die Erstellung von Texten und Bildungsinhalten im Projekt folgt ebenfalls einem strukturierten, offenen Prozess, der sich eng an Software-Entwicklungsworkflows anlehnt. **Redaktionelle Beiträge (z.B. Blogartikel, Handreichungen, Lehrmodule)** entstehen in Kollaboration über Git:
![](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/raw/branch/add-blogpost-so-arbeiten-wir/Website/content/posts/2025-04-10-So-arbeiten-wir/Redaktionsprozess.png)
![](Redaktionsprozess.png)
- **Ideenfindung und Planung:** Neue Inhalte starten häufig als *Issue*. Hat jemand z.B. die Idee für einen Blogbeitrag über ein Projektthema, wird ein Issue mit einem sprechenden Titel erstellt (z.B. der Issue [*"Blogbeitrag Workflow/Selbstmanagement darstellen"*](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/issues/329), der zu diesem Artikel geführt hat. In der Beschreibung können bereits Stichpunkte oder ein grober Umriss festgehalten werden. Das Issue wird typischerweise dem Board *Blogposts Redaktion* zugeordnet und mit Label *Blog* markiert. So ist von Anfang an klar, dass es sich um eine redaktionelle Aufgabe handelt. Oft werden in der frühen Phase im Issue schon **Rollen verteilt** etwa wer den ersten Entwurf schreibt und wer später gegenliest und **Material gesammelt** (Quellen, Links, Abbildungen).
@ -149,7 +149,7 @@ Ergänzend zu Git nutzen wir für die redaktionelle Zusammenarbeit auch Kommunik
Unsere Arbeitsweise verkörpert **Open Educational Practices** auf mehreren Ebenen. OEP bedeutet, dass nicht nur die Endprodukte offen sind, sondern der gesamte Prozess auf Offenheit, Partizipation und kontinuierliches Lernen ausgelegt ist. Im Projekt FOERBICO setzen wir dies folgendermaßen um:
![](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/raw/branch/add-blogpost-so-arbeiten-wir/Website/content/posts/2025-04-10-So-arbeiten-wir/Grafik-1.jpg)
![](Grafik-1.jpg)
- **Transparenz der Prozesse:** Alle Projektaktivitäten werden offen sichtbar gemacht. Das Issue-Tracking ist abgesehen von eventuell sensiblen Einträgen öffentlich einsehbar. Externe können nachvollziehen, woran das Team arbeitet, welche Probleme diskutiert werden und wie Lösungen gefunden werden. Diese *Working-out-loud*-Philosophie fördert Vertrauen und lässt Stakeholder am Fortschritt teilhaben, ohne dass wir für Berichte extra geschlossene Kreisläufe brauchen. Selbst unsere Zeitplanung (Meilensteine) und Dokumentation sind als Dateien öffentlich versioniert, nicht in internen Ordnern versteckt. Das erhöht auch die *Verbindlichkeit*: Was einmal im Issue festgehalten ist, wird nicht übersehen.