Beispiel: Commits auf einem Branch
Beispiel: Commits auf einem Branch
Ashgrove Studio entwickelt ashgrove/storefront, einen Onlineshop, der jedes Mal ausgeliefert wird,
wenn etwas auf main landet. Es gibt keine Versionen und keine Releases: Der Branch ist das
Produkt. Das Team will in #storefront-changes eine Zusammenfassung dessen, was live gegangen ist,
ohne eine Nachricht für jeden einzelnen Push.
Wann das passt
Einen Branch zu beobachten passt zu einem Repository ohne Releases, oder zu einem Team, das die Arbeit zwischen zwei Releases sehen will. Ein Repository mit Releases ist meist besser bedient, wenn es diese ankündigt: Sie tragen Notes, die jemand für Leser geschrieben hat, und eine Commit-Zeile ist für das Team geschrieben.
Was auf GitHub entsteht
Pushes auf main, jeder mit einem oder mehreren Commits. GitHub meldet einen Push an ein
Repository, auf dem die App von Chronik.io installiert ist. Ein Repository, das nur beobachtet wird,
ohne die App, meldet keinen, und die Regel sagt das, statt den Schalter anzubieten.
Die Regel
- Welches Repository?
ashgrove/storefront. - Wohin soll gepostet werden? Der Slack-Workspace und
#storefront-changes. Commits werden nur in Slack angekündigt; für Discord, Telegram oder einen Webhook steht der Schalter nicht zur Wahl. - Welche Vorlage? Standard verwenden.
- Was soll beobachtet werden?
- Veröffentlichte Releases und Gepushte Tags: aus, weil dieses Repository keins von beidem hat.
- Commits, die auf einen Branch gepusht werden: an. Die Regel erklärt dann, was gepostet wird, nämlich die erste Zeile jedes Commits, auch aus einem privaten Repository, lesbar für alle im Kanal, und lässt es dich mit Mir ist klar, was gepostet wird bestätigen.
- Welcher Branch:
main.
Ein eigener Kanal ist der bessere Ort für Commits. Bekommt der gewählte Kanal schon die Release-Ankündigungen desselben Repositorys, weist der Assistent darauf hin.
Was im Kanal ankommt
Nicht eine Nachricht je Push. Der erste Push öffnet ein Sammelfenster, und jeder weitere schiebt sein Ende nach hinten; ist der Branch 30 Minuten lang still, geht eine Nachricht raus. Ein Branch, der nie still wird, bekommt seine Nachricht spätestens nach zwei Stunden, und ein neues Fenster beginnt.
Die Nachricht ist als intern gekennzeichnet, nennt den Branch und die Zahl der Commits, listet die ersten Zeilen von bis zu zehn davon, sagt, wie viele es darüber hinaus waren, und verlinkt den Vergleich auf GitHub, wo der Rest zu lesen ist. Namen von Autoren nennt sie nicht.
Was schiefgehen kann
- Ein Force-Push schreibt die Geschichte des Branches neu. Die Nachricht sagt dann, dass die Geschichte umgeschrieben wurde, statt Commits aufzuzählen, die es vielleicht nicht mehr gibt.
- Ein Geheimnis in einer Commit-Zeile erreicht den Kanal wie jede andere Zeile. Dafür ist die Bestätigung vor dem Schalter da; ein privates Repository ändert daran nichts.
- Es kommt nichts an, wenn die App nicht auf dem Repository installiert ist oder der Name des Branches einen Tippfehler hat: Eine Regel auf einem Branch, auf den niemand pusht, sieht genauso aus wie ein stiller Branch.