Comenius-Institut/FOERBICO

Fork 1

Projektplan Gantt-Diagramm: Markdown-Datei aus Repo nutzen (Deployment per Woodpecker) #309

New issue

Open

opened 2025-03-12 10:43:07 +00:00 by sicking · 5 comments

sicking commented

2025-03-12 10:43:07 +00:00

Owner

Die Markdown-Datei foerbico-projekplan-gantt.md, die dem Gantt-Diagramm unter https://projekt.oer.community/gantt/ zugrunde liegt, soll bei einer Änderung "automatisch" (per Woodpecker) auf dem Server aktualisiert werden.

❗ Achtung ⚠️ ❗

Wenn die Pipeline in dem Branch "feature/publish-gantt-markdown" ausgeführt wird, wird die produktive Markdown-Datei "gantt.md" überschrieben!

Die Markdown-Datei [foerbico-projekplan-gantt.md](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/src/branch/main/foerbico-projekplan-gantt.md), die dem Gantt-Diagramm unter https://projekt.oer.community/gantt/ zugrunde liegt, soll bei einer Änderung "automatisch" (per Woodpecker) auf dem Server aktualisiert werden. ---- ❗ **Achtung** ⚠️ ❗ Wenn die Pipeline in dem Branch "feature/publish-gantt-markdown" ausgeführt wird, wird die produktive Markdown-Datei "gantt.md" überschrieben!

sicking added the

oer.community

technik

labels 2025-03-12 10:43:24 +00:00

sicking commented

2025-03-12 10:47:24 +00:00

Author

Owner

Noch (ab)zu klärende Fragen:

soll die md-Datei im Repo "dynamisch" gefunden werden (find ...) oder kann der Pfad in der Pipeline-YAML hart kodiert stehen?
Wann soll die Pipeline laufen (nur nach Push/Änderung nach main?) - bevorzuge ich => when Condition anpassen
Wo wird die md-Datei schlussendlich liegen? Unter welchem Pfad? => Filter "include" entsprechend anpassen
Wie öffentlich dürfen/sollten Interna sein? (z. B. Pfad zur gantt Datei auf dem Server) - ich bevorzuge gar nicht öffentlich

Noch (ab)zu klärende Fragen: - soll die md-Datei im Repo "dynamisch" gefunden werden (`find ...`) oder kann der Pfad in der Pipeline-YAML hart kodiert stehen? - Wann soll die Pipeline laufen (nur nach Push/Änderung nach `main`?) - bevorzuge ich => when Condition anpassen - Wo wird die md-Datei schlussendlich liegen? Unter welchem Pfad? => Filter "include" entsprechend anpassen - Wie öffentlich dürfen/sollten Interna sein? (z. B. Pfad zur gantt Datei auf dem Server) - ich bevorzuge _gar nicht_ öffentlich

sicking commented

2025-03-12 10:53:55 +00:00

Author

Owner

proof of concept:

Datei Organisation/projektplan-gantt.md im Branch "feature/publish-gantt-markdown"
- Arbeitspakete 100-...
Ergebnis: https://projekt.oer.community/gantt/proof-of-concept/

proof of concept: - Datei [Organisation/projektplan-gantt.md](https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/src/branch/feature/publish-gantt-markdown/Organisation/projektplan-gantt.md) im Branch "feature/publish-gantt-markdown" - Arbeitspakete **100-**... - Ergebnis: https://projekt.oer.community/gantt/proof-of-concept/

👍 1

sicking commented

2025-03-12 11:02:03 +00:00

Author

Owner

Meta-Anmerkung: warum schreibe ich das hier so (ausführlich)?

Als mögliches Beispiel für

wie könnten wir etwas dokumentieren
wie könnte das unser asynchrones Arbeiten unterstützen
wie könnte es als Grundlage dienen, für das Füttern eines Sprachmodells (ich vermeide mal das Wort "KI" ;-)

Als Frage

was braucht es, damit wir (noch) besser asynchron / schriftlich miteinander arbeiten können
- ohne in einer Informationsflut (Chat, Mail, Commit...) unterzugehen?
hilft so ein Beispiel wie dieses?
wie, wo, ... wollen wir dazu Vorschläge sammeln, Verabredungen treffen... etc.

**Meta-Anmerkung:** warum schreibe ich das hier so (ausführlich)? Als _mögliches_ Beispiel für - wie könnten wir etwas dokumentieren - wie könnte das unser asynchrones Arbeiten unterstützen - wie könnte es als Grundlage dienen, für das Füttern eines Sprachmodells (ich vermeide mal das Wort "KI" ;-) Als Frage - was braucht es, damit wir (noch) besser asynchron / schriftlich miteinander arbeiten können - ohne in einer Informationsflut (Chat, Mail, Commit...) unterzugehen? - hilft so ein Beispiel wie dieses? - wie, wo, ... wollen wir dazu Vorschläge sammeln, Verabredungen treffen... etc.

joerglohrer commented

2025-03-12 15:25:54 +00:00

Owner

Noch (ab)zu klärende Fragen:

soll die md-Datei im Repo "dynamisch" gefunden werden (find ...) oder kann der Pfad in der Pipeline-YAML hart kodiert stehen?

Da es ein sehr spezifischer Anwendungsfall ist, reicht meines Erachtens die harte Codierung, wie in https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/src/branch/feature/publish-gantt-markdown/.woodpecker/publish-gantt-markdown.yaml
Zumal die index.html und das mermaid.js ja ohnehin separat via ssh oder ftp hochgeladen werden muss, oder?

Wann soll die Pipeline laufen (nur nach Push/Änderung nach main?) - bevorzuge ich => when Condition anpassen

Ja, sehe ich genauso wie bevorzugt

Wo wird die md-Datei schlussendlich liegen? Unter welchem Pfad? => Filter "include" entsprechend anpassen

Ich würde vorschlagen unter /Organsation noch einen Unterordner /Projektkoordination anzulegen.

Wie öffentlich dürfen/sollten Interna sein? (z. B. Pfad zur gantt Datei auf dem Server) - ich bevorzuge gar nicht öffentlich

Die gantt-Datei kann ja im Quelltext der index.html ausgelesen werden. Insofern ist sie nach Publikation ohnehin öffentlich:
view-source:https://projekt.oer.community/gantt/gantt.md oder view-source:https://projekt.oer.community/gantt/proof-of-concept/gantt.md

> Noch (ab)zu klärende Fragen: > > soll die md-Datei im Repo "dynamisch" gefunden werden (`find ...`) oder kann der Pfad in der Pipeline-YAML hart kodiert stehen? Da es ein sehr spezifischer Anwendungsfall ist, reicht meines Erachtens die harte Codierung, wie in https://git.rpi-virtuell.de/Comenius-Institut/FOERBICO/src/branch/feature/publish-gantt-markdown/.woodpecker/publish-gantt-markdown.yaml Zumal die index.html und das mermaid.js ja ohnehin separat via ssh oder ftp hochgeladen werden muss, oder? > - Wann soll die Pipeline laufen (nur nach Push/Änderung nach `main`?) - bevorzuge ich => when Condition anpassen Ja, sehe ich genauso wie bevorzugt > - Wo wird die md-Datei schlussendlich liegen? Unter welchem Pfad? => Filter "include" entsprechend anpassen Ich würde vorschlagen unter /Organsation noch einen Unterordner /Projektkoordination anzulegen. > - Wie öffentlich dürfen/sollten Interna sein? (z. B. Pfad zur gantt Datei auf dem Server) - ich bevorzuge _gar nicht_ öffentlich Die gantt-Datei kann ja im Quelltext der index.html ausgelesen werden. Insofern ist sie nach Publikation ohnehin öffentlich: view-source:https://projekt.oer.community/gantt/gantt.md oder view-source:https://projekt.oer.community/gantt/proof-of-concept/gantt.md

joerglohrer commented

2025-03-12 15:33:50 +00:00

Owner

Meta-Anmerkung: warum schreibe ich das hier so (ausführlich)?

was braucht es, damit wir (noch) besser asynchron / schriftlich miteinander arbeiten können

Diese aufgabenbezogene Kommunikation finde ich tatsächlich zielorientierter als per Zuruf im Chat. Gleichzeitig gibt es auch immer offene Fragen, die des Austauschs bedürfen. Wie können wir solche Klärungsbedarfe auf der Meta-Ebene initiieren?
Issue auf Meeting-Agenda? Referenz zum Issue in Element?

- ohne in einer Informationsflut (Chat, Mail, Commit...) unterzugehen?
hilft so ein Beispiel wie dieses?

ja, auf jeden Fall, gleichzeitig zeigt es auch, dass sich aus dem Konkreten immer wieder weitere Bedarfe öffnen und Frage, wie wir das organisieren über Referenzierung, neue Issues, Chat, ...

wie, wo, ... wollen wir dazu Vorschläge sammeln, Verabredungen treffen... etc.

Ich schlage vor, dass wir die Readme ausbauen und dort auch ein "So arbeiten wir" verlinken in dem wir unsere Arbeitsweisen beschreiben.

> **Meta-Anmerkung:** warum schreibe ich das hier so (ausführlich)? > - was braucht es, damit wir (noch) besser asynchron / schriftlich miteinander arbeiten können Diese aufgabenbezogene Kommunikation finde ich tatsächlich zielorientierter als per Zuruf im Chat. Gleichzeitig gibt es auch immer offene Fragen, die des Austauschs bedürfen. Wie können wir solche Klärungsbedarfe auf der Meta-Ebene initiieren? Issue auf Meeting-Agenda? Referenz zum Issue in Element? > - ohne in einer Informationsflut (Chat, Mail, Commit...) unterzugehen? > - hilft so ein Beispiel wie dieses? ja, auf jeden Fall, gleichzeitig zeigt es auch, dass sich aus dem Konkreten immer wieder weitere Bedarfe öffnen und Frage, wie wir das organisieren über Referenzierung, neue Issues, Chat, ... > - wie, wo, ... wollen wir dazu Vorschläge sammeln, Verabredungen treffen... etc. Ich schlage vor, dass wir die Readme ausbauen und dort auch ein "So arbeiten wir" verlinken in dem wir unsere Arbeitsweisen beschreiben.