Год назад первая неделя у нового инженера выглядела примерно так: ему скидывают ссылку на Notion с надписью «начни отсюда», там вместо страницы сообщение «404 — страница перемещена», в Slack-канале #welcome открывают треды, в которых половина людей уже не работает в компании, а половина ссылок ведёт на устаревшие гугл-доки.
Никто не делал это специально. Просто никто не отвечал за это конкретно.
Что мы поменяли
Мы сделали одну страницу — «Маршрут первой недели». Живой документ в Pasklove (своя собака собственный корм), в котором:
- каждый день недели — отдельный раздел с конкретными задачами;
- каждая задача — checkbox с ответственным;
- каждый раздел заканчивается «на чём ты должен застрять, чтобы это было нормально» — список ожидаемых трудностей;
- в самом конце — форма обратной связи «что было непонятно».
Главное правило этого документа — он обновляется человеком, который проходит онбординг сам, прямо в процессе. Заметил, что инструкция устарела? Поправил. Не понял шаг? Добавил комментарий и попросил автора прокомментировать. Через месяц новый человек проходит более актуальную версию, чем ты сам прошёл.
Документация, которую обновляет автор раз в полгода — мертва. Документация, которую обновляет читатель в момент чтения — живая.
Что сломалось
Не всё прошло гладко. Через два месяца страница расползлась — её начали править все, и она превратилась в свалку. Решили двумя вещами:
- ввели роль «куратор онбординга» — человек на квартал, который сводит правки и держит структуру;
- добавили в редактор v2 функцию «предложить правку» (sneak peek: выйдет в 2.4) — изменения не применяются сразу, а ждут одобрения куратора.
Метрика
Раньше «время до первого продакшен-PR» у новых инженеров было 11 рабочих дней (медиана), сейчас 5. Это много за счёт чего, не только за счёт документа — мы ещё переписали инструкцию по локальной сборке и завели dev-окружение в облаке для тех, кому не хочется ставить всё локально. Но один документ, который всегда актуален, дал больше всего.
Можно у себя
Шаблон «Маршрут первой недели» доступен в библиотеке шаблонов Pasklove (с версии 2.2.0). Импортируйте в своё рабочее пространство — и вы уже на половине пути.