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