De referenties die je team steeds kwijtraakt
"in één gedeelde lijst in plaats van veertig open tabbladen"
Engineering reading listshared
Frontend6
Backend5
Infra4
Onboarding3
One list, the whole team
Iemand vraagt welke tool het team gebruikt voor het bijhouden van fouten. Drie mensen antwoorden, twee van hen fout, en het echte antwoord is een tabblad dat een van hen in maart heeft gesloten. Dat is het hele probleem, en het is geen documentatieprobleem — je wiki is prima, je wiki is alleen niet waar iemand kijkt. Een gedeeld Glubler bevat de referenties zelf: de frontend-bibliotheekgids die iedereen opnieuw leest, de backendservice die iemand in een reactietraad vond, de vier links die een nieuwkomer nodig heeft voordat hij iets kan opleveren. Eén benoemde plek, onderhouden door de mensen die hem gebruiken, en het antwoord op de vraag hierboven ligt er al.
Gedeeld, niet geërfd en eerlijk over de gaten
Interne referentielijsten gaan vrijwel altijd op dezelfde manier ten einde. Iemand stelt er in een paar maanden een samen, ze leeft in hun browser, iedereen vindt hem nuttig, en stilletjes wordt het hun lijst in plaats van die van het team — en dan vertrekt hij ermee. Hem ergens delen lost het eigendomsprobleem op en legt een tweede bloot: een lijst dekt alleen wat de auteur toevallig nodig had. Behandel dekking dus als iets dat je controleert in plaats van aanneemt, kijk welke rol er niets in heeft, en laat de mensen die het gemerkt hebben het invullen. Een Glubler is openbaar tenzij je hem sluit, en juist dat maakt dit mogelijk zonder iemand om toestemming te vragen.
Coverage by role
Frontend6
Backend5
Infra4
Designnone
Gapnothing Design needs yet
Including the gap
Splits het zoals mensen het echt vragen in plaats van op wanneer je het hebt opgeslagen in plaats van een lange kolom
Een platte kolom van veertig links beantwoordt niets, want niemand die hem leest weet welke zes van toepassing zijn op de vraag die voor hem ligt. Splits dezelfde verzameling in Subglubler die naar het werk zijn genoemd — frontend, backend, infra, onboarding — en de vraag lost zichzelf op, en de volgende ook. Het maakt de lijst bovendien onderhoudbaar, want een nieuwkomer die toevoegt wat hem vorige week ontbrak, heeft een voor de hand liggende plek om het te zetten in plaats van te gokken. Groeperen is niet netheid. Het is het verschil tussen een referentielijst die mensen raadplegen en een waar ze langs scrollen.
Engineering reading listpublic
New joiner3 to start
New to Backend5 to read
Leavinglist stays
It outlives whoever made it
Hij overleeft degene die hem maakte elke nieuwkomer erft de hele boel
Bij onboarding verdient dit zichzelf meteen terug. In plaats van zes links in een chatbericht en een vage instructie om rond te vragen, opent de nieuwe persoon één lijst en leest de drie die op dag één tellen — en weet dan waar de andere dertig wonen als hij ze nodig heeft. En als degene die hem samenstelde vertrekt, breekt er niets, want de lijst was nooit van hem. Dat is het verschil tussen documentatie die bij een team hoort en een verzameling tabbladen die toevallig op één machine openstonden.
Begin een gedeelde lijstReferenties, niet je eigen documentatie
Wees duidelijk waar dit voor is, want het woord documentatie nodigt uit tot de verkeerde vergelijking. Een Glubler is niet waar je team dingen opschrijft — beslissingen, runbooks, onboardingstappen en architectuurnotities horen in wat je daar al voor gebruikt, en een lijst met links is een slechte vervanger voor geen van die. Het is voor de ANDERE helft: de externe referenties die het bewaard waard zijn. De specificatie die je elke maand opnieuw leest, de gids die de bug van vorige maand oploste, de toolvergelijking die niemand ooit heeft opgeschreven. Dat zijn websites, ze staan op de server van iemand anders, en ze horen bij elkaar op een plek die het team kan bereiken.
Vier rollen, vier verschillende lijsten
Een frontend-engineer en een data-engineer hebben vrijwel niets gemeen, en een lijst die beiden wil bedienen, bedient uiteindelijk niemand. Opsplitsen op rol lost dat met opzet op: elke persoon opent de ene groep die op hem van toepassing is en sluit de tab op de rest, en dat is precies waarom ze er zullen terugkomen. Het maakt de gaten ook vindbaar. Wanneer de datagroep leeg is, heb je iets ontdekt wat het weten waard is, en de oplossing is dat één persoon vier links toevoegt in plaats van een kwartaalaudit dat niemand heeft ingepland.
FrontendComponent patterns
BackendMigrations, indexes
Hoort bij het team, niet bij degene die hem maakte
Elke nuttige referentielijst begint als iemands privé stapeltje en blijft dat tot iemand er bewust een gedeelde van maakt. De stap is klein — hem ergens zetten waar het team hem kan bereiken, hem naar het werk noemen in plaats van naar jezelf, en mensen er aan laten toevoegen — en dat is het verschil tussen een hulpmiddel en een artefact. Niets anders op deze pagina is zo belangrijk: een lijst die één persoon heeft gecurd is een favoriet, en een lijst die het team onderhoudt is iets waarop je kunt vertrouwen zonder te vragen aan wie je moet vragen.
Een lijst delen
De eerste week, één keer opgelost
Bij onboarding verdienen gedeelde referenties zichzelf meteen terug. Zes links in een chatbericht worden één keer gelezen en verdwijnen; een lijst met een kleine onboardinggroep wordt elke keer geopend als er iemand begint, en ze wordt beter omdat de nieuwste persoon degene is die merkte wat er ontbrak. Opsplitsen op rol betekent dat elke nieuwkomer drie dingen leest in plaats van veertig, en dat is het verschil tussen een eerste week vol lezen en een eerste week vol opleveren.
Onboarding opzetten
Iets beters gevonden? Voeg het toe
Referenties verouderen, en een link die stilletjes is verlopen leert mensen de hele lijst wantrouwen zodra hij hen een ochtend kost. Een Glubler lost de correctie in één stap op — plak de nieuwe site, plak de dode los — en iedereen kan dat doen zonder de eigenaar te zoeken of een ticket te openen. Na een jaar is de lijst beter dan die waarmee je begon, en dat is de enige duurzame manier om er een te houden, en niemand hoeft de opschoning in te plannen die nooit gebeurt.
Plakken en losplakkenGlubler VOOR
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.