Ссылки, которые ваша команда всё время теряет
"в одном общем списке вместо сорока открытых вкладок"
Кто-то спрашивает, каким инструментом команда пользуется для отслеживания ошибок. Три человека отвечают, двое неверно, и настоящий ответ — вкладка, которую один из них закрыл в марте. В этом и заключается вся проблема, и она не в документации — ваша вики в порядке, ваша вики просто не там, куда смотрят. Общий 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 для документации команды — коллекции сайтов