Wiki anlegen: Langform zu den Bausteinen und das Gemessene
Vier Seiten, bewusst nicht mehr. Die Aufteilung ist dieselbe wie in
jlab-cluster/helm-charts: Das README bleibt die Kurzreferenz fuer Aufrufer —
was ein Baustein tut, die Eingabe-Tabelle, ein Aufrufbeispiel, die
Voraussetzungen — und wird dafuer nicht gekuerzt. Das Wiki ist die Langform:
warum die Dinge so sind und was dafuer gemessen wurde.
Home nennt das Repository, verweist auf die Bausteine und fasst die zwei
Hausregeln in je einem Satz: an einen Tag binden, ein Eigentuemer-Segment nie
raten.
docker-build-push und publish-helm-chart tragen die Begruendungen. Beim
Publish-Baustein vor allem die Eigenschaften des Upload-Schritts: warum
--fail-with-body noetig ist, weil curl einen 401 sonst mit Code 0 verlaesst,
und warum der Dateiname gebaut und nicht geglobt wird, weil --upload-file genau
eine Datei nimmt. Im README waeren diese Saetze zu lang; ohne sie entfernt sie
irgendwann jemand als Umstand.
Gemessenes-Verhalten sammelt die Eigenheiten dieser Forge, die hier teuer waren:
boolesche workflow_call-Eingaben kommen nicht an, wandernde Action-Verweise,
und ein fehlendes Secret laesst die Job-Erzeugung scheitern statt den Job, sodass
der Lauf ohne Schritte dasteht. Letzteres ist in jlab-cluster/helm-charts
gemessen; die Quelle steht auf der Seite.
Keine Tag-Nummern und keine Fassungen als Momentaufnahme: Welcher Tag gilt,
steht im README und in der Workflow-Datei. Was hier steht, sind Begruendungen
und Messungen.
jklein