Regeln für Apps

Was die App eines Teams braucht, bevor sie mit mehreren Teams oder der ganzen Organisation geteilt wird: ein Repository, grüne CI, Tests, Überwachung, wer veröffentlicht, und die eigenen Regeln deines Workspaces für jede App. Die ersten zwei Wochen nur melden, danach durchgesetzt.

Eine kleine App für dich selbst soll eine Minute dauern. Eine App, auf die sich die ganze Organisation verlässt, verdient echtes Engineering. Die Regeln deines Workspaces für Apps legen fest, was eine App braucht, bevor sie einen größeren Kreis erreicht, und ich halte jede App daran.

Regeln je Kreis

Je breiter eine App geteilt wird, desto mehr braucht sie. Mit diesen Regeln startet jeder Workspace:

Regel Nur ich Mein Team Mehrere Teams Ganze Organisation
Echtes Repository Nein, ich halte die Versionen Nein Erforderlich Erforderlich
CI Keine Keine Lint und Tests grün Lint und Tests grün, dazu die Referenz-Checks deines Workspaces
Automatische Tests Keine Keine Mindestens einer Einer für jede Datenänderung
Überwachung Keine Health-Check Health-Check und Alarme an das verantwortliche Team Health-Check, Uptime, Alarme und eine benannte verantwortliche Person
Wer veröffentlicht Wer sie ändern darf Wer sie ändern darf Ein Lead des Teams Ein Workspace-Admin
Erst Staging Optional Optional Erforderlich Erforderlich
Design und Regeln Angewendet, Befunde sichtbar Angewendet, Befunde sichtbar Durchgesetzt Durchgesetzt
Wenn etwas fehlt Nur melden Nur melden Zurückhalten Zurückhalten
  • Teilen mit einzelnen Personen zählt wie mehrere Teams.
  • Referenz-Checks sind CI-Jobs mit Namen (zum Beispiel sast, licences) oder die Jobs, die ein von dir genanntes Referenz-Repository besteht. Sie müssen auf dem Hauptbranch des App-Repositories grün sein, bevor eine App für die ganze Organisation freigegeben wird. Das Referenz-Repository legst du unter den Regeln in Workspace-Einstellungen > Apps fest; es darf auf einem anderen Code-Host liegen als deine Apps, und sind mehrere Code-Hosts verbunden, wählst du den richtigen. Kann ich es nicht lesen, steht bei der Regel, warum.
  • Erst Staging heißt: Eine neue Version läuft auf der Staging-Kopie der App, bevor du sie live schaltest. Wo es optional ist, kann die verantwortliche Person der App es einschalten.
  • Teams können diese Regeln nur verschärfen. Die eigenen Regeln eines Teams können mehr verlangen, nie weniger.

Wenn du eine App breiter teilst und etwas fehlt, sage ich dir in deinem Chat in einfachen Worten, was ihr noch fehlt, zum Beispiel „Grüne CI für lint, tests“ oder „Ein Lead des Teams veröffentlicht sie“. Bitte mich, und ich kümmere mich um das, was ich kann: Ich verschiebe die App in ein Repository, schreibe Tests aus deinen Sätzen und richte ihre Überwachung ein. Wenn App-Repositories für dein Team aus sind, sage ich das, statt sie einzuschalten; ein Lead schaltet sie unter Team-Einstellungen > Repositories ein.

Die ersten zwei Wochen

Die Regeln starten in jedem Workspace mit Nur melden, zwei Wochen lang ab dem ersten Teilen einer App. In dieser Zeit teile ich die App trotzdem und sage dir, was sie brauchen wird, sobald die Regeln gelten. Nach zwei Wochen gelten die Kreise mit Zurückhalten: Eine App, der etwas fehlt, bleibt, wo sie war, bis sie bereit ist. Die Workspace-Einstellungen zeigen, in welcher Phase dein Workspace ist.

Regeln für jede App

Lege eigene Regeln in einfachen Worten fest, zum Beispiel „jede Seite zeigt unser Logo im Kopf“, „Tabellen nutzen unsere Statusfarben“ oder „keine internen Abkürzungen in Beschriftungen“. Jede Regel betrifft Stil, Aufbau oder Formulierung und ist entweder ein Muss oder ein Hinweis.

  • Ich baue jede App von der ersten Version an nach den Regeln deines Workspaces.
  • Nach jeder Version prüft jemand, der sie nicht gebaut hat, die Version gegen jede Regel. Was dabei auffällt, erscheint an der App als Befund.
  • Eine Muss-Regel hält eine App zurück, wo Design und Regeln durchgesetzt wird. Sonst erscheint sie als Befund, damit das Team sie vor dem breiteren Teilen beheben kann.

Regeln ändern

Am schnellsten sagst du es mir im Chat: „Apps für die ganze Organisation brauchen zwei Tests“, „Teilen mit mehreren Teams soll nur melden“ oder „jede App nutzt unser Logo“. Ich zeige dir, was sich ändert, und ein Workspace-Admin übernimmt es mit einem Tippen. Jede Änderung ist eine neue Version, steht im Audit-Log und lässt sich rückgängig machen.

Du kannst die Regeln auch unter Workspace-Einstellungen > Apps ansehen und bearbeiten. Alle im Workspace können sie lesen; Eigentümer und Admins bearbeiten sie.

Mit einzelnen Personen teilen

Neben Teams kannst du eine App unter Teilen > Ausgewählte Teams oder Personen auch mit einzelnen Personen teilen. Nur Personen aus deinem Workspace lassen sich nennen, und jede Freigabe kann nach 30 oder 90 Tagen von selbst enden. Sie öffnen die veröffentlichte Version mit ihren eigenen Rechten und erfahren davon in ihrem Chat.

Verwandte Seiten

Zuletzt aktualisiert: January 1, 0001

kanman öffnen