Ссылки, которые ваша команда всё время теряет
"в одном общем списке вместо сорока открытых вкладок"
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.