Контроль за внесением изменений

Теперь у дизайнеров есть свой репозиторий и проект с документацией. У лидера дизайн-системы появляется новая ответственность — контроль за внесением изменений, ведь любой член команды может что-то закоммитить в main-ветку, а вы об этом никогда не узнаете.

Вспомните наши принципы, наша документация должна быть исчерпывающей, в еще авторитетной и правдивой. Должна вызывать в дизайнерах чувство беспрецедентного доверия и быть единым источником правды. Этого не добиться без жесткого контроля со стороны ответственных лиц дизайн-системы.

Давайте организуем такой контроль.

Контроль за мастер-веткой документации

Откройте Github и перейдите Settings → Branches:

Нажмите на кнопку Add classic branch protection rule и установите следующие настройки для ветки main:

Суть настроек в том, что никто, кроме администраторов или пользователей с расширенными правами, не сможет закоммитить в main-ветку без создания Pull Request. Кроме того, проверить такой Pull Request должен будет специальный пользователь, которым мы назначим вас.

Дополнить эти настройки нужно специальным файлом — CODEOWNERS. Почитайте документацию, файл имеет очень гибкую система настроек. Если у вас несколько лидов в дизайн-системе, то каждый из них может отвечать за контроль изменения конкретных разделов, если вам помогают разработчики, они могут контролировать изменения скриптов или каких-то системных файлов.

У нас всего этого нет, поэтому мы будем единоличными ревьюерами. Что все это значит? Это значит, что все изменения, которые пытаются попасть в репозиторий через Pull request обязательно потребуют вашего ревью. Только вы сможете пропустить изменения в мастер-ветку.

Сначала действуем стандартно. Создайте задачу в Issues и ветку для внесения изменений:

Откройте Cursor и переключитесь на созданную ветку с помощью команды:

git fetch origin

git checkout 38

В корне проекта создайте файл CODEOWNERS, поставьте звездочку, а напротив нее напишите ваш логин на Github через @:

Запушьте изменения в репозиторий, создайте Pull request и вмерджите изменения в main-ветку. Мы все это делали при публикации принципов.

Теперь все Pull request, кроме ваших, будут требовать дополнительного согласования от вас.

Контроль за main-веткой в Фигме

Так как Фигма это тоже репозиторий, но в дизайнерской оболочке, у нее есть похожий механизм. Он очень подробно описан в гайдах по ветвлению и ревью. В следующих главах мы настроим хранение библиотеки компонентов и вы сможете применить новые знания.