Die Referenzen, die Ihr Team ständig verliert
"in einer gemeinsamen Liste statt in vierzig offenen Tabs"
Jemand fragt, welches Werkzeug das Team für das Fehlertacking benutzt. Drei Leute antworten, zwei davon falsch, und die wahre Antwort ist ein Tab, den einer davon im März geschlossen hat. Das ist das ganze Problem, und es ist kein Dokumentationsproblem — Ihre Wiki ist in Ordnung, Ihre Wiki ist nur der Ort, an dem niemand nachschaut. Ein gemeinsames Glubler enthält die Referenzen selbst: die Frontend-Bibliotheksanleitung, die alle erneut lesen, den Backend-Service, den jemand in einem Kommentar-Thread gefunden hat, die vier Links, die eine neue Person braucht, bevor sie irgendetwas ausliefern kann. Ein benannter Ort, gepflegt von denen, die ihn benutzen, und die Antwort auf die Frage von oben liegt schon darin.
Geteilt, nicht geerbt und ehrlich über die Lücken
Interne Referenzlisten sterben fast immer auf dieselbe Weise. Jemand stellt eine über ein paar Monate zusammen, sie lebt in seinem Browser, alle finden sie nützlich, und stillschweigend wird sie zu seiner Liste statt zu der des Teams — dann geht sie mit ihm. Sie an einem gemeinsamen Ort abzulegen löst das Eigentumsproblem und legt ein zweites frei: Eine Liste deckt nur ab, was ihr Autor zufällig brauchte. Behandeln Sie Abdeckung also als etwas, das Sie prüfen, nicht als etwas, das Sie annehmen, sehen Sie, welche Rolle gar nichts darin hat, und lassen Sie die Menschen, die es bemerkt haben, es auffüllen. Ein Glubler ist öffentlich, sofern Sie ihn nicht schließen — und genau das macht es möglich, ohne jemanden um Erlaubnis zu fragen.
Teilen Sie es so, wie Leute tatsächlich fragen statt danach, wann Sie es gespeichert haben statt als eine lange Spalte
Eine flache Spalte aus vierzig Links beantwortet nichts, denn niemand, der sie liest, weiß, welche sechs auf die Frage vor ihm zutreffen. Teilen Sie dieselbe Menge in Subglubler, die nach der Arbeit benannt sind — Frontend, Backend, Infra, Onboarding — und die Frage löst sich von selbst, und die nächste auch. Das macht die Liste außerdem pflegbar, denn eine neue Person, die letzte Woche das hinzufügt, was ihr gefehlt hat, hat einen offensichtlichen Platz dafür, statt zu raten. Gruppierung ist keine Ordentlichkeit. Sie ist der Unterschied zwischen einer Referenzliste, die Leute nachschlagen, und einer, die sie überscrollen.
Sie überdauert den, der sie gebaut hat jede neue Person erbt das Ganze
Beim Onboarding zahlt sich das sofort aus. Statt sechs Links in einer Chatnachricht und einer vagen Anweisung, sich umzuhören, öffnet die neue Person eine Liste und liest die drei, die am ersten Tag zählen — und weiß dann, wo die anderen dreißig liegen, wenn sie sie braucht. Und wenn die Person geht, die sie zusammengestellt hat, bricht nichts, weil die Liste nie ihre war. Das ist der Unterschied zwischen Dokumentation, die einem Team gehört, und einer Sammlung von Tabs, die auf einer Maschine offen waren.
Starten Sie eine gemeinsame Liste

Referenzen, nicht Ihre eigene Dokumentation

Seien Sie klar, wofür das gedacht ist, denn das Wort Dokumentation lädt zum falschen Vergleich ein. Ein Glubler ist nicht der Ort, an dem Ihr Team Dinge aufschreibt — Entscheidungen, Runbooks, Onboarding-Schritte und Architekturnotizen gehören in das, was Sie dafür schon verwenden, und eine Linkliste ist ein schlechter Ersatz für nichts davon. Es ist für die ANDERE Hälfte gedacht: die externen Referenzen, die es wert sind, behalten zu werden. Die Spezifikation, die Sie jeden Monat neu lesen, die Anleitung, die letzten Monat den Fehler beantwortet hat, der Werkzeugvergleich, den niemand je aufzuschreiben Zeit hatte. Das sind Webseiten, sie liegen auf dem Server eines anderen, und sie gehören an einen Ort, den das Team erreichen kann.

Vier Rollen, vier verschiedene Listen

Ein Frontend-Entwickler und ein Data-Entwickler haben fast nichts gemeinsam, und eine Liste, die beiden dienen soll, bedient am Ende niemanden. Sie nach Rolle zu teilen behebt das absichtlich: Jede Person öffnet die eine Gruppe, die auf sie zutrifft, und schließt den Rest — genau deshalb kommen sie wieder. Es macht die Lücken außerdem auffindbar. Wenn die Data-Gruppe leer ist, haben Sie etwas herausgefunden, das es zu wissen wert ist, und die Korrektur ist eine Person, die vier Links hinzufügt, statt ein vierteljährliches Audit, das niemand terminiert hat.

Gehört dem Team, nicht dem, der es gemacht hat

Jede nützliche Referenzliste beginnt als jemandes privater Haufen und bleibt so, bis jemand absichtlich eine gemeinsame daraus macht. Der Schritt ist klein — sie dorthin legen, wo das Team sie erreichen kann, sie nach der Arbeit benennen statt nach sich selbst, und die Leute sie ergänzen lassen — und er ist der Unterschied zwischen einer Ressource und einem Artefakt. Nichts anderes auf dieser Seite ist so wichtig: Eine Liste, die eine Person kuratiert hat, ist ein Favorit, und eine Liste, die das Team pflegt, ist etwas, worauf man sich verlassen kann, ohne zu fragen, wen man fragen muss.

Eine Liste teilen

Die erste Woche, einmal gelöst

Beim Onboarding zahlen sich gemeinsame Referenzen sofort aus. Sechs Links in einer Chatnachricht werden einmal gelesen und gehen verloren; eine Liste mit einer kleinen Onboarding-Gruppe wird jedes Mal geöffnet, wenn jemand neu anfängt, und sie wird besser, weil die neueste Person diejenige ist, die bemerkt hat, was gefehlt hat. Nach Rolle geteilt liest jede neue Person drei Dinge statt vierzig, und das ist der Unterschied zwischen einer ersten Woche voller Lesen und einer ersten Woche voller Auslieferung.

Onboarding einrichten

Etwas Besseres gefunden? Fügen Sie es hinzu

Referenzen veralten, und ein Link, der still veraltet ist, bringt den Leuten bei, der ganzen Liste zu misstrauen, sobald er ihnen einen Morgen verschwendet. Ein Glubler erledigt die Korrektur in einem Schritt — die neue Seite festkleben, die tote lösen — und das kann jeder, ohne den Verantwortlichen zu finden oder ein Ticket zu öffnen. Über ein Jahr hinweg ist die Liste besser als die, mit der Sie angefangen haben, und das ist die einzige nachhaltige Weise, eine zu führen, und niemand muss die Aufräumaktion einplanen, die nie stattfindet.

Festkleben und lösen
Glubler FÜR
TEAMS

Not a wiki. The list beside it.

Keep your own writing where it belongs. Use a Glubler for the references your team keeps losing — grouped by role, shared by default, and open for anyone who finds something better to add.

Glubler für Team-Dokumentation – Webseiten-Sammlungen