Korrekturen und Erläuterungen #365
3 changed files with 25 additions and 4 deletions
|
|
@ -74,17 +74,17 @@ Wir nutzen konsequent eine offene, git-basierte Infrastruktur zur Organisation d
|
|||
|
||||
## Versionsverwaltung und Repository-Struktur
|
||||
|
||||
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.de**](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.
|
||||
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.de**](https://git.rpi-virtuell.de/) ([Forgejo](https://forgejo.org/)-basiert). Ein Git-Repository kann man sich als einen Ablageort von Dateien vorstellen, an dem man leicht verschiedene Bearbeitungsstände (Versionen) verwalten kann. [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. Ein Branch (wörtlich "Zweig") ist die Sammlung von Änderungen ab einem gewissen Bearbeitungsstand. Durch einen Commit lässt sich ein Bearbeitungsstand festlegen, der einen Zwischenstand aller erfolgten Änderungen enthält. So ein Commit lässt sich später z. B. veröffentlichen ("push"), wiederherstellen, abändern oder "weiterreichen". Die Nutzung von Git ermöglicht uns sehr flexibel und genau, **Änderungen an Dateien nachzuverfolgen**, frühere Versionen wiederherzustellen und parallel an verschiedenen Inhalten (durch mehrere Branches) 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 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.
|
||||
**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 von uns neu erstellten oder bearbeiteten Materialien 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.
|
||||
|
||||
Zusätzlich zum Hauptrepository existieren weitere spezialisierte Repositories innerhalb der selbstgehosteten Git-Plattform sowie auf gitlab und github, etwa für die Verwaltung von Metadaten. Ein Beispiel ist das [**OERSI-Datensatz**-Repository](https://gitlab.com/comenius-institut/foerbico/oersi-datensatz), über das wir Metadaten zu unseren OER-Inhalten für den übergreifenden OER-Search-Index (OERSI) bereitstellen (dies wurde im Oktober 2024 angelegt und enthält strukturierte Metadaten). Solche Teil-Repositories ermöglichen es, technische Komponenten oder Datenbestände auszulagern und separat zu versionieren, während wir über das Hauptprojekt-Repository die Gesamtkoordination behalten. Alle Repositories unter dem FOERBICO-Dach sind im Comenius-Institut Gitlab/Forgejo aufgeführt und mit dem Projekt verknüpft, was eine konsistente Nutzung von Issues und Meilensteinen (siehe unten) über Projektgrenzen hinweg ermöglicht.
|
||||
|
||||
## Aufgabenverwaltung mit Issues, Labels und Meilensteinen
|
||||
|
||||
Zur **Organisation von Aufgaben und Projektmanagement** nutzen wir intensiv das integrierte Issue-Tracking-System der Git-Plattform. Jedes Arbeitspaket, jede Idee oder jedes Problem wird als **Issue** erfasst. Dies fördert transparente Diskussionen: alle Kommentare, Entscheidungen und Zuständigkeiten zu einer Aufgabe sind an einem Ort dokumentiert. Aktuell werden über 100 [offene Issues in unserem Hauptrepository](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/issues) parallel verwaltet (Stand April 2025: z. B. 125 offene und 115 geschlossene Issues), was den aktiven Fortschritt und kontinuierlichen Abschluss von Aufgaben widerspiegelt.
|
||||
Zur **Organisation von Aufgaben und Projektmanagement** nutzen wir intensiv das integrierte Issue-Tracking-System der Git-Plattform. Jedes Arbeitspaket, jede Idee oder jedes Problem wird als **Issue** erfasst. Ein Issue darf man sich wie eine Karte auf einer Pinnwand vorstellen, auf der eine Frage, ein Thema oder Problem festeghalten ist und dort diskutiert wird. So wird eine transparente Diskussionen gefördert: alle Kommentare, Entscheidungen und Zuständigkeiten zu einer Aufgabe sind an einem Ort dokumentiert. Aktuell werden über 100 [offene Issues in unserem Hauptrepository](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/issues) parallel verwaltet (Stand April 2025: z. B. 125 offene und 115 geschlossene Issues), was den aktiven Fortschritt und kontinuierlichen Abschluss von Aufgaben widerspiegelt.
|
||||
|
||||
**Label-System:** Um die Vielzahl an Issues übersichtlich zu halten, etablieren wir ein **System von Labels (Schlagworten)** und ordnen Zuständigkeiten sowie die Meilensteine aus den Arbeitspaketen unserer Projektplanung zu. Jedes Issue wird mit mindestens einem Label versehen, das seinen Typ oder Themenbereich kennzeichnet. Beispiele für Labelkategorien in unserem Projekt sind:
|
||||
|
||||
|
|
|
|||
|
|
@ -57,7 +57,7 @@ title: 'Rückblick auf den HackathOERn in Göttingen: Gemeinsam für starke OER-
|
|||
cover:
|
||||
relative: true
|
||||
image: gina-ludger-joerg.jpg
|
||||
caption: "Ludger, Jörg und Gina vom Comenius-Institut für das FOERBICO-Team beim HackathOERn in Göttingen"
|
||||
caption: "Jörg, Ludger und Gina vom Comenius-Institut für das FOERBICO-Team beim HackathOERn in Göttingen"
|
||||
summary: >-
|
||||
Vom 28. bis 30. April 2025 kamen beim ersten HackathOERn von edu-sharing in Göttingen Akteur:innen aus dem OER-Bereich zusammen, um gemeinsam an digitalen Lösungen zur Stärkung von Open Educational Resources (OER) und Open Educational Practices (OEP) zu arbeiten. Im Mittelpunkt standen Vernetzung, Wissenstransfer und die kollaborative Weiterentwicklung eingereichter Projektideen bis hin zu ersten Prototypen.
|
||||
url: hackathoern
|
||||
|
|
|
|||
21
Website/scripts/indent-tags-values.sh
Executable file
21
Website/scripts/indent-tags-values.sh
Executable file
|
|
@ -0,0 +1,21 @@
|
|||
#!/bin/bash
|
||||
set -e
|
||||
|
||||
# script im root dir ausführen
|
||||
working_directory=$(basename $(pwd))
|
||||
if [ "$working_directory" != "FOERBICO" ]; then
|
||||
echo "not in root dir 'FOERBICO'"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
find Website/content -type f -name 'index.md' | while read FILE ;
|
||||
do
|
||||
#sed -i -s -E 's|^- | - |g' $FILE
|
||||
sed -i '/^---$/,/^---$/ {
|
||||
/^- / s/^/ /
|
||||
}' $FILE
|
||||
done
|
||||
|
||||
|
||||
#sed '/^---$/,/^---$/ { /^-/ s/^/ / }' input.md
|
||||
#$sed '/^---$/,/^---$/ { /^- / s/^/ / }' Website/content/posts/2025-04-11-OER-Hochschulreihe-Teil-3/index.md | less
|
||||
Loading…
Add table
Add a link
Reference in a new issue