Изменения в коде проходят через ветку, дифф, назначенного ревьюера и слияние. Изменения в дизайне часто ограничиваются сообщением в канале и ссылкой на фрейм. Потом они встречаются в продакшене, и никто не может сказать, какое изменение было одобрено. Мы предлагаем проводить дизайн-ревью как код-ревью: взять из работы с кодом то, что делает изменения прослеживаемыми, и применить это к дизайн-системе.
Коротко
- Код-ревью работает благодаря четырём вещам: изолированной ветке, видимому диффу, владельцу, без одобрения которого не обойтись, и слиянию, которое фиксирует решение.
- В Figma есть аналоги почти для всех из них: ветки, ревью веток и статусы Dev Mode. Пользоваться ими нужно осознанно.
- Обычно не хватает шага передачи: изменение дизайна должно стать pull request с ревью, а не сообщением.
- Назначьте каждой части системы владельца с обеих сторон и сделайте pull request местом, где встречаются одобрения дизайна и кода.
Почему код-ревью работает
Если разобрать код-ревью до основы, останутся четыре механизма:
Часть с владельцем GitHub даже автоматизирует. Если в репозитории есть файл CODEOWNERS, то «владельцы кода автоматически запрашиваются на ревью, когда кто-то открывает pull request, изменяющий код, которым они владеют» (GitHub). Правило защиты ветки с опцией «Require review from Code Owners» делает их одобрение обязательным.
Ничего из этого не относится именно к коду. Это способ сделать изменения видимыми, а за каждым решением закрепить ответственного.
Те же механизмы в Figma
В Figma есть аналоги почти для всей таблицы, хотя их легко пропустить.
Ветки. Figma описывает ветки как «контролируемые среды, в которых можно исследовать изменения дизайна, прототипов и библиотек, не редактируя исходный файл» (Figma). Ветки доступны на тарифах Organization и Enterprise, с Full seat.
Ревью. Ветку можно отправить на ревью. Ревьюеры сравнивают её с основным файлом, рядом или наложением, и одобряют её или предлагают правки. Figma также отмечает, что «слить ветку может любой, у кого есть право редактировать основной файл» (Figma). Поэтому ревью здесь держится на договорённости, а не на жёстком запрете.
Статусы. В Dev Mode дизайнеры могут пометить секцию как Ready for dev. Если секцию потом отредактируют, Figma пометит её как изменённую (Figma). Ближе к подписи, которую видят разработчики, ничего нет. Что эта пометка отслеживает, а что нет, мы разобрали в заметке о Dev Mode и Code Connect.
Для библиотеки дизайн-системы ветка на каждое изменение и назначенный ревьюер уже закрывают изоляцию и владение. Дифф и запись перенести труднее, потому что изменение библиотеки не заканчивается в Figma.
Где процесс ломается: передача
Публикация обновления библиотеки служит слиянием на стороне дизайна. То, что происходит дальше, обычно вообще не проходит ревью. Кто-то экспортирует токены, копирует иконки или обновляет компонент. Изменение попадает в код в составе большого pull request'а или не попадает вовсе.
С этого начинается расхождение дизайн-системы. В Figma одно, в продакшене другое, и нигде не записано, какое отличие было задумано.
Решение в том, чтобы сделать передачу отдельным изменением:
- Одно изменение библиотеки, один pull request. Всё, что изменилось в одной библиотеке, приходит вместе, в pull request'е, где больше ничего нет.
- Читаемый дифф. Pull request перечисляет добавленное, изменённое и удалённое по именам, а не только как изменения файлов. Например, ревьюер должен увидеть «в тёмной теме изменился
color.bg.surface», а не длинный дифф JSON. - Владельцы с обеих сторон. Дизайнер подтверждает, что изменение именно то, которое задумывалось. Разработчик подтверждает, что со стороны кода оно безопасно.
CODEOWNERSможет запросить разработчика автоматически, например для папки с токенами. - Слияние как запись. Когда pull request сливают, изменение кода и его одобрения фиксируются в одном месте, со ссылкой на библиотеку.
Кто чем владеет
Владение командам даётся труднее всего, потому что дизайн-система живёт в двух инструментах. Мы бы начали с простого разделения:
Запишите это рядом с кодом: пути в CODEOWNERS, а сторону дизайна в руководстве для контрибьюторов репозитория. Если изменение затрагивает обе стороны, оба владельца смотрят один и тот же pull request.
Ревью разницы, а не файла
Ревьюеры кода читают диффы. Ревьюерам дизайна нужен аналог: что изменилось, показанное рядом. GitHub уже умеет показывать изменения изображений в pull request'е тремя способами: 2-up, swipe и onion skin (GitHub). Для иконок и иллюстраций, которые приходят файлами изображений, этого часто хватает, чтобы заметить непреднамеренное изменение.
Для токенов список изменённых имён со старыми и новыми значениями лучше любого диффа файлов. Для компонентов важно сравнение варианта в Figma с тем, что рендерит код. Для этого ревьюер дизайна и ревьюер кода должны смотреть на одно и то же изменение одновременно. Что проверять в коде изменения интерфейса, объясняет наше руководство по ревью UI, сгенерированного ИИ.
Место FISYCO
Мы делаем FISYCO, чтобы передача стала изменением с ревью. Когда библиотека в Figma меняется, FISYCO доставляет её в ваш репозиторий pull request, в котором есть только эта библиотека. Это работает одинаково для иконок, иллюстраций и токенов.
В описании pull request'а по именам перечислено, что добавлено, изменено и удалено. Там же есть ссылки на библиотеку и на синхронизацию, которая его создала. На странице библиотеки видны превью её элементов, так что дизайнер может просмотреть их до того, как владелец кода сольёт pull request. Когда pull request смотрят оба владельца, слияние фиксирует оба решения. Всё, что изменилось в Figma, но так и не дошло до кода, видно как расхождение.



