Посилання, які ваша команда постійно втрачає
"в одному спільному списку замість сорока відкритих вкладок"
Хтось питає, який інструмент команда використовує для відстеження помилок. Троє відповідають, двоє неправильно, і справжня відповідь — вкладка, яку один із них закрив у березні. У цьому й полягає вся проблема, і вона не в документації — ваша вікі в порядку, ваша вікі просто не там, куди дивляться. Спільний Glubler містить самі посилання: посібник із фронтенд-бібліотекою, який усі перечитують, бекенд-сервіс, знайдений кимось у гілці коментарів, чотири посилання, без яких новенький нічого не випустить. Одне назване місце, яке підтримують ті, хто ним користується, і відповідь на запитання вище вже лежить усередині.
Спільний, а не успадкований і чесний щодо прогалин
Внутрішні списки посилань помирають майже завжди однаково. Хтось збирає такий протягом кількох місяців, він живе в його браузері, усім він корисний, і непомітно він стає його списком, а не списком команди — а потім іде разом із ним. Покласти його в спільне місце розв'язує проблему власності, але відкриває другу: список покриває лише те, що автору випадково знадобилося. Тож ставтеся до повноти як до того, що ви перевіряєте, а не припускаєте, подивіться, у якій ролі порожньо, і дозвольте тим, хто помітив, заповнити. Glubler відкритий, доки ви його не закриєте, — саме це й робить можливим не питаючи ні в кого дозволу.
Діліть так, як люди насправді питають а не за тим, коли ви це зберегли а не одним довгим стовпцем
Плоский стовпець із сорока посилань нічого не відповідає, бо ніхто, хто його читає, не знає, які шість стосуються питання, яке в нього перед очима. Розбийте той самий набір на Subglubler, названі за роботою — фронтенд, бекенд, інфраструктура, онбординг — і питання розв'яжеться саме, і наступне теж. Це водночас робить список підтримуваним: новенький, який додає те, чого йому бракувало минулого тижня, отримує очевидне місце, куди це покласти, замість здогадів. Групування — це не охайність. Це різниця між списком посилань, до якого заглядають, і тим, який прокручують.
Він переживе того, хто його зібрав кожен новий працівник успадковує все
На онбордингу це окупається відразу. Замість шести посилань у повідомленні чату й розмитої вказівки «запитайте в когось» нова людина відкриває один список і читає три, важливі в перший день, — а потім знає, де живуть інші тридцять, коли вони знадобляться. І коли той, хто його збирав, іде, нічого не ламається, бо список ніколи не був його. Це різниця між документацією, що належить команді, і колекцією вкладок, які просто опинилися відкритими на одній машині.
Почніть спільний список

Посилання, а не власна документація

Чітко поясніть, для чого це потрібно, бо слово «документація» провокує неправильне порівняння. Glubler — не те місце, де ваша команда записує рішення, runbook-и, кроки онбордингу та нотатки з архітектури; усе це належить тому, що ви вже використовуєте для цього, а список посилань — погана заміна будь-чому з цього. Він потрібен для ІНШОЇ половини: для зовнішніх посилань, які варто зберегти. Специфікація, яку ви перечитуєте щомісяця, посібник, що розв'язав баг минулого місяця, порівняння інструментів, до якого ніхто так і не дійшов. Це сайти, вони живуть на чужому сервері, і їм місце там, куди команда може дійти.

Чотири ролі — чотири різні списки

У фронтенд-розробника та інженера даних майже немає нічого спільного, а список, який намагається обслужити обох, зрештою не обслуговує нікого. Розбиття за ролями розв'язує це свідомо: кожен відкриває ту єдину групу, яка стосується його, і закриває вкладку на решту — саме тому вони туди й повертатимуться. Це водночас робить прогалини помітними. Коли група з даних порожня, ви дізналися щось, про що варто знати, і рішення — це одна людина додає чотири посилання замість щоквартального аудиту, якого ніхто не призначив.

Належить команді, а не тому, хто його зробив

Кожен корисний список посилань починається як чиясь приватна купа і лишається нею, доки хтось свідомо не зробить його спільним. Крок невеликий — покласти його туди, куди команда може дістатися, назвати його за роботою, а не за себе, і дозволити людям доповнювати його, — і саме це відрізняє ресурс від артефакту. Ніщо інше на цій сторінці не таке важливе: список, який курує одна людина, — це обране, а список, який підтримує команда, — це те, на що можна покластися, не питаючи, кого питати.

Зробити список спільним

Перший тиждень, розв'язаний один раз

На онбордингу спільні посилання окупаються негайно. Шість посилань у повідомленні чату читають один раз і втрачають, а список із невеликою групою для онбордингу відкривають щоразу, коли хтось починає, і він стає кращим, бо новенький — це саме той, хто помітив відсутнє. Розбиття за ролями означає, що кожен новенький читає три речі замість сорока, і це різниця між першим тижнем, витраченим на читання, і першим тижнем, витраченим на випуск.

Налаштувати онбординг

Знайшли щось краще — додайте

Посилання застарівають, а посилання, що тихо протухло, навчає людей не довіряти всьому списку з першої ж хвилини, на яку воно їх витратило. 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.

Glubler для документації команди — колекції сайтів