Les références que votre équipe perd sans cesse
"dans une liste partagée plutôt que dans quarante onglets ouverts"
Engineering reading listshared
Frontend6
Backend5
Infra4
Onboarding3
One list, the whole team
Quelqu'un demande quel outil l'équipe utilise pour le suivi des erreurs. Trois personnes répondent, deux à tort, et la vraie réponse est un onglet que l'une d'elles a fermé en mars. C'est tout le problème, et ce n'est pas un problème de documentation — votre wiki va bien, votre wiki est simplement l'endroit où personne ne regarde. Un Glubler partagé contient les références elles-mêmes : le guide de la bibliothèque frontend que tout le monde relit, le service backend que quelqu'un a trouvé dans un fil de commentaires, les quatre liens dont un nouvel arrivant a besoin avant de livrer quoi que ce soit. Un lieu nommé, tenu par ceux qui l'utilisent, et la réponse à la question ci-dessus s'y trouve déjà.
Partagée, pas héritée et honnête sur les trous
Les listes de références internes meurent presque toujours de la même façon. Quelqu'un en monte une sur quelques mois, elle vit dans son navigateur, tout le monde la trouve utile, et elle devient discrètement la sienne plutôt que celle de l'équipe — puis elle part avec lui. La mettre dans un endroit partagé règle la question de la propriété et en révèle une seconde : une liste ne couvre que ce que son auteur avait besoin. Traitez donc la couverture comme quelque chose que vous vérifiez au lieu de supposer, regardez quel rôle n'y a rien, et laissez ceux qui l'ont remarqué compléter. Un Glubler est public sauf si vous le fermez, et c'est ce qui rend la chose possible sans demander la permission à qui que ce soit.
Coverage by role
Frontend6
Backend5
Infra4
Designnone
Gapnothing Design needs yet
Including the gap
Découpez comme on le demande vraiment plutôt que selon la date d'enregistrement plutôt qu'une longue colonne
Une colonne plate de quarante liens ne répond à rien, parce que personne en la lisant ne sait lesquels des six s'appliquent à la question qu'il a sous les yeux. Découpez le même ensemble en Subglubler nommés d'après le travail — frontend, backend, infra, intégration — et la question se résout d'elle-même, tout comme la suivante. Cela rend aussi la liste maintenable, car un nouvel arrivant qui ajoute ce qui lui manquait la semaine dernière a un endroit évident où le mettre au lieu de deviner. Le regroupement n'est pas de la rangement. C'est la différence entre une liste de références que l'on consulte et une que l'on fait défiler.
Engineering reading listpublic
New joiner3 to start
New to Backend5 to read
Leavinglist stays
It outlives whoever made it
Elle survit à celui qui l'a faite chaque nouvel arrivant hérite de tout
C'est à l'intégration que cela paie immédiatement. Au lieu de six liens dans un message de chat et d'une consigne vague de demander autour, la nouvelle personne ouvre une liste et lit les trois qui comptent le premier jour — puis sait où vivent les trente autres quand elle en aura besoin. Et quand la personne qui l'a montée part, rien ne casse, parce que la liste n'a jamais été la sienne. C'est la différence entre une documentation qui appartient à une équipe et une collection d'onglets qui se sont trouvés ouverts sur une seule machine.
Commencez une liste partagéeDes références, pas votre propre documentation
Soyez clair sur l'usage, car le mot documentation invite à la mauvaise comparaison. Un Glubler n'est pas l'endroit où votre équipe note ses choses — décisions, runbooks, étapes d'intégration et notes d'architecture appartiennent à ce que vous utilisez déjà pour cela, et une liste de liens est un mauvais substitut à tout cela. C'est pour l'AUTRE moitié : les références externes qui valent la peine d'être conservées. La spécification que vous relisez chaque mois, le guide qui a résolu le bug le mois dernier, le comparatif d'outils que personne n'a jamais pris le temps d'écrire. Ce sont des sites, ils vivent sur le serveur de quelqu'un d'autre, et ils appartiennent ensemble quelque part où l'équipe peut les atteindre.
Quatre rôles, quatre listes différentes
Un ingénieur frontend et un ingénieur data n'ont presque rien en commun, et une liste qui essaie de servir les deux finit par ne servir personne. La découper par rôle règle cela à dessein : chacun ouvre le seul groupe qui le concerne et ferme l'onglet sur le reste, ce qui est exactement pourquoi il y reviendra. Cela rend aussi les trous repérables. Quand le groupe data est vide, vous avez appris quelque chose qui vaut la peine d'être su, et la correction consiste à ce qu'une personne ajoute quatre liens plutôt qu'à faire un audit trimestriel que personne n'a planifié.
FrontendComponent patterns
BackendMigrations, indexes
Appartient à l'équipe, pas à celui qui l'a faite
Toute liste de références utile commence comme le tas privé de quelqu'un et le reste jusqu'à ce que quelqu'un en fasse délibérément une liste partagée. Le geste est petit — la mettre là où l'équipe peut l'atteindre, la nommer d'après le travail plutôt que d'après soi, et laisser les gens y ajouter — et c'est la différence entre une ressource et un artefact. Rien d'autre sur cette page n'est aussi important : une liste curatée par une personne est un favori, et une liste entretenue par l'équipe est quelque chose sur quoi on peut compter sans avoir à demander à qui demander.
Partager une liste
La première semaine, réglée une fois
L'intégration est là où les références partagées paient immédiatement. Six liens dans un message de chat sont lus une fois puis perdus ; une liste avec un petit groupe d'intégration est ouverte chaque fois que quelqu'un commence, et elle s'améliore parce que la personne la plus récente est celle qui a remarqué ce qui manquait. La découper par rôle signifie que chaque nouvel arrivant lit trois choses au lieu de quarante, et c'est la différence entre une première semaine passée à lire et une première semaine passée à livrer.
Mettre en place l'intégration
Vous avez trouvé mieux, ajoutez-le
Les références périment, et un lien devenu obsolète en silence apprend aux gens à se méfier de toute la liste dès la première fois qu'il leur fait perdre une matinée. Un Glubler règle la correction en une étape — coller le nouveau site, décoller le mort — et n'importe qui peut le faire sans trouver le responsable ni ouvrir un ticket. Au bout d'un an la liste est meilleure que celle du départ, et c'est la seule façon durable d'en tenir une, sans que personne n'ait à planifier le rangement qui n'arrive jamais.
Coller et décollerGlubler POUR
ÉQUIPES
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.