Посилання, які ваша команда постійно втрачає
"в одному спільному списку замість сорока відкритих вкладок"
Engineering reading listshared
Frontend6
Backend5
Infra4
Onboarding3
One list, the whole team
Хтось питає, який інструмент команда використовує для відстеження помилок. Троє відповідають, двоє неправильно, і справжня відповідь — вкладка, яку один із них закрив у березні. У цьому й полягає вся проблема, і вона не в документації — ваша вікі в порядку, ваша вікі просто не там, куди дивляться. Спільний Glubler містить самі посилання: посібник із фронтенд-бібліотекою, який усі перечитують, бекенд-сервіс, знайдений кимось у гілці коментарів, чотири посилання, без яких новенький нічого не випустить. Одне назване місце, яке підтримують ті, хто ним користується, і відповідь на запитання вище вже лежить усередині.
Спільний, а не успадкований і чесний щодо прогалин
Внутрішні списки посилань помирають майже завжди однаково. Хтось збирає такий протягом кількох місяців, він живе в його браузері, усім він корисний, і непомітно він стає його списком, а не списком команди — а потім іде разом із ним. Покласти його в спільне місце розв'язує проблему власності, але відкриває другу: список покриває лише те, що автору випадково знадобилося. Тож ставтеся до повноти як до того, що ви перевіряєте, а не припускаєте, подивіться, у якій ролі порожньо, і дозвольте тим, хто помітив, заповнити. Glubler відкритий, доки ви його не закриєте, — саме це й робить можливим не питаючи ні в кого дозволу.
Coverage by role
Frontend6
Backend5
Infra4
Designnone
Gapnothing Design needs yet
Including the gap
Діліть так, як люди насправді питають а не за тим, коли ви це зберегли а не одним довгим стовпцем
Плоский стовпець із сорока посилань нічого не відповідає, бо ніхто, хто його читає, не знає, які шість стосуються питання, яке в нього перед очима. Розбийте той самий набір на Subglubler, названі за роботою — фронтенд, бекенд, інфраструктура, онбординг — і питання розв'яжеться саме, і наступне теж. Це водночас робить список підтримуваним: новенький, який додає те, чого йому бракувало минулого тижня, отримує очевидне місце, куди це покласти, замість здогадів. Групування — це не охайність. Це різниця між списком посилань, до якого заглядають, і тим, який прокручують.
Engineering reading listpublic
New joiner3 to start
New to Backend5 to read
Leavinglist stays
It outlives whoever made it
Він переживе того, хто його зібрав кожен новий працівник успадковує все
На онбордингу це окупається відразу. Замість шести посилань у повідомленні чату й розмитої вказівки «запитайте в когось» нова людина відкриває один список і читає три, важливі в перший день, — а потім знає, де живуть інші тридцять, коли вони знадобляться. І коли той, хто його збирав, іде, нічого не ламається, бо список ніколи не був його. Це різниця між документацією, що належить команді, і колекцією вкладок, які просто опинилися відкритими на одній машині.
Почніть спільний списокПосилання, а не власна документація
Чітко поясніть, для чого це потрібно, бо слово «документація» провокує неправильне порівняння. Glubler — не те місце, де ваша команда записує рішення, runbook-и, кроки онбордингу та нотатки з архітектури; усе це належить тому, що ви вже використовуєте для цього, а список посилань — погана заміна будь-чому з цього. Він потрібен для ІНШОЇ половини: для зовнішніх посилань, які варто зберегти. Специфікація, яку ви перечитуєте щомісяця, посібник, що розв'язав баг минулого місяця, порівняння інструментів, до якого ніхто так і не дійшов. Це сайти, вони живуть на чужому сервері, і їм місце там, куди команда може дійти.
Чотири ролі — чотири різні списки
У фронтенд-розробника та інженера даних майже немає нічого спільного, а список, який намагається обслужити обох, зрештою не обслуговує нікого. Розбиття за ролями розв'язує це свідомо: кожен відкриває ту єдину групу, яка стосується його, і закриває вкладку на решту — саме тому вони туди й повертатимуться. Це водночас робить прогалини помітними. Коли група з даних порожня, ви дізналися щось, про що варто знати, і рішення — це одна людина додає чотири посилання замість щоквартального аудиту, якого ніхто не призначив.
FrontendComponent patterns
BackendMigrations, indexes
Належить команді, а не тому, хто його зробив
Кожен корисний список посилань починається як чиясь приватна купа і лишається нею, доки хтось свідомо не зробить його спільним. Крок невеликий — покласти його туди, куди команда може дістатися, назвати його за роботою, а не за себе, і дозволити людям доповнювати його, — і саме це відрізняє ресурс від артефакту. Ніщо інше на цій сторінці не таке важливе: список, який курує одна людина, — це обране, а список, який підтримує команда, — це те, на що можна покластися, не питаючи, кого питати.
Зробити список спільним
Перший тиждень, розв'язаний один раз
На онбордингу спільні посилання окупаються негайно. Шість посилань у повідомленні чату читають один раз і втрачають, а список із невеликою групою для онбордингу відкривають щоразу, коли хтось починає, і він стає кращим, бо новенький — це саме той, хто помітив відсутнє. Розбиття за ролями означає, що кожен новенький читає три речі замість сорока, і це різниця між першим тижнем, витраченим на читання, і першим тижнем, витраченим на випуск.
Налаштувати онбординг
Знайшли щось краще — додайте
Посилання застарівають, а посилання, що тихо протухло, навчає людей не довіряти всьому списку з першої ж хвилини, на яку воно їх витратило. Glubler розв'язує виправлення одним кроком — приліпте новий сайт, відліпте мертвий, — і це може зробити будь-хто, не шукаючи власника й не відкриваючи тікет. За рік список стає кращим за той, з якого ви почали, і це єдиний стійкий спосіб його вести, і нікому не треба планувати прибирання, якого ніколи не буває.
Приліпити і відліпитиGlubler ДЛЯ
КОМАНДИ
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.