243. Фигма – лучшая документация

Особенность айтишных продуктов – со временем никто не помнит, как всё работает. Я говорю не про коробочный продукт и не про сделанное на заказ для крупного клиента – там обычно есть документация. Я про типичный SAAS продукт. Он развивается итеративно, проводится множество экспериментов, делаются пивоты, меняются руководители и целые команды.

Через несколько лет никто не знает, как работает продукт. Кое что покрыто регрессионными тестами, но они проверяют лишь базовую логику. Как это работает «в принципе» знал только продакт, который уволился три года назад.

Бывает продакт описывает логику в техническом задании, но это случается редко. Обычно задачи ставятся в виде бедно оформленных карточек и обсуждаются устно и в чатах. Что делать менеджеру, кто придет через пару лет и будет пытаться разобраться «как это работает»? Я нашел выход – это Фигма.

Я прошу UX-дизайнера прорабатывать вместе со мной все состояния системы и фиксировать их в фигма макетах. Мы записываем комментарии по логике работы рядом с макетами на ярких плашках. Фигмовские нативные комментарии используем только для обсуждений, логику в них не пишем. Логика должна быть в виде простого текста рядышком с макетом.

Правильно сделанные макеты в Фигме – хорошее описание системы. Оно наглядно и понятно всем участникам – бэку, фронту, QA, менеджерам.

Конечно, макеты быстро устаревают. Но их в любом случае нужно делать, так что это как бы «бесплатная» документация. Нужно лишь проработать все состояния и дополнить их текстовыми комментариями.