Меню
Поиск

Работа в команде · Передача в разработку

Как подготовить макет к передаче в разработку

Приведите файл в порядок, выделите актуальное решение и проверьте компоненты. Добавьте контекст задачи, подписи и материалы. В уроке — тренажёры и карточка передачи.

Пример для всего урока. В вымышленной «Лесной обжарке» покупатель выбирает способ получения кофе до оплаты. Вы готовите макет этого блока к разработке. Названия, задачи и договорённости ниже учебные.

1Покажите, какое решение собирать

Разработчику нужно найти актуальное решение и понять его статус.

Выделите точку входа

Дайте ссылку на нужный экран или раздел файла. Рядом укажите задачу, состав текущего выпуска и статус решения. Проверьте, что коллега может открыть ссылку.

Если доступ зависит от учётной записи, уточните его до начала работы. Скриншот можно приложить для обсуждения; для реализации понадобится доступ к согласованным материалам.

Отделите рабочее решение от вариантов

Сохраните черновики для истории, но обозначьте их статус. Если рядом лежат несколько версий без пояснений, разработчик будет выбирать между ними.

Сравните:

Сравните варианты

Ссылка на весь файл

Вот макеты корзины. Последний вариант где-то справа.

Нужно искать экран и выяснять, какой из вариантов согласован.

Вход в текущую задачу

Собираем блок получения из раздела для разработки. Черновики находятся в архиве. Выбор города в этот выпуск не входит.

Видно, где начать и какой объём использовать. Само согласование ещё нужно проверить с командой.

Статус рядом со ссылкой помогает прочитать макет в нужном контексте.

Назовите неизвестное

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

Например:

Срок получения зависит от склада. Пока разработчик проверяет источник данных, подпишите срок как пример и отметьте вопрос о доступности расчёта.

2Организуйте файл вокруг задачи

Понятные названия помогают искать нужную часть решения и обсуждать изменения.

Назовите экраны по сценарию

Используйте названия, которые понимает команда: получение заказа, ошибка расчёта, подтверждение выбора. Сохраняйте последовательность сценария и обозначьте варианты состояния.

Например:

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

Проверьте слои и группы

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

Команде не нужен отдельный словарь для каждого декоративного слоя. Договоритесь о названиях, которые помогают найти компонент, состояние или материал для экспорта.

Проверьте статус материалов

Тренажёр: что перед вами
  1. Раздел подписан «В разработку», связан с задачей; команда согласовала состав выпуска.

  2. Рядом лежит вариант другого способа выбора, помеченный как отклонённый.

  3. Доступность срока зависит от ответа команды сервера; в макете стоит пример.

  4. Экран из прошлого выпуска лежит в архиве с датой и пояснением.

  5. Согласованный экран ошибки связан с тем же выпуском, что и основной экран.

  6. У нового значка нет утверждённого назначения, его обсуждают в комментариях.

Определяйте статус по договорённости команды, а не по положению экрана в файле.

3Сверьте компоненты с библиотекой

Перед передачей проверьте, из каких элементов собран макет и что команда уже использует в продукте.

Используйте согласованные элементы

Проверьте кнопки, поля и выбор способа получения. Если библиотека содержит подходящий компонент, возьмите его актуальный вариант. Уточните соответствие компоненту в коде.

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

Проверьте свойства и стили

Сверьте состояние, размер, подписи и применённые стили. Если элемент выглядит как компонент, но собран вручную, отметьте отличие и обсудите, как его реализовать.

USWDS объясняет дизайн-токены как ограниченный набор именованных значений для оформления. При передаче укажите согласованный стиль или токен, если команда уже связывает его с кодом.

Запишите обоснованные отличия

Если нужен новый вариант, объясните задачу и покажите отличие от существующего. Уточните с дизайнером библиотеки и разработчиком, кто проверит его поведение.

Название токена само по себе не подтверждает совпадение макета и продукта. Попросите разработчика сверить связь с текущей реализацией.

4Добавьте контекст и нужные материалы

Макет должен помогать понять задачу, содержание и назначение элементов.

Опишите место в сценарии

Коротко назовите, откуда покупатель приходит в блок и куда идёт после выбора. Дайте ссылку на задачу и соседние экраны, если они влияют на реализацию.

МатериалЧто пояснить
Текущий макетКакой раздел и выпуск собирать
СценарийЧто человек делает до и после этого экрана
КомпонентыКакие элементы уже есть в библиотеке и коде
Открытые вопросыЧто неизвестно и кто уточняет
ИзображенияКакие файлы нужны и как они используются

Проверьте содержание

Замените случайные подписи согласованным текстом. Если содержание ещё готовит редактор, обозначьте это и договоритесь, где появится окончательная версия.

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

Подготовьте изображения

С разработчиком уточните формат, размеры и способ использования файлов. Назовите материалы по назначению и проверьте, что экспорт соответствует выбранному элементу.

Укажите, несёт ли изображение смысл или служит украшением. Для смыслового изображения согласуйте текстовое описание; для декоративного обсудите исключение из чтения скринридером.

5Пройдите материалы вместе с разработчиком

Совместный просмотр помогает обнаружить вопросы до подробной сборки.

Покажите один сценарий

Откройте точку входа и пройдите выбор получения. Покажите состав выпуска, компоненты и неизвестные детали. Попросите коллегу назвать, что он начнёт собирать.

Сохраните ответы в задаче

После обсуждения обновите подписи и материалы. Свяжите решение со своей задачей. Если договорённость осталась только в разговоре, другой участник может её не найти.

Уточните, кто ответит на новые вопросы во время разработки. Обсудите, где будете проверять работающий вариант; подготовка файла не завершает совместную работу.

Проверьте готовность передачи

Тренажёр: можно ли начинать
  1. Есть ссылка на текущий раздел, доступ проверен, объём согласован, вопросы с ответственными перечислены.

  2. Все экраны подписаны «Финал», но команда не выбирала актуальный вариант.

  3. Срок получения в примере подписан как реальные данные, хотя источник пока неизвестен.

  4. Новый вариант компонента отмечен, отличие описано, его проверяет назначенный коллега.

  5. Разработчик не открывает ссылку, поэтому получает только снимок основного экрана.

  6. После совместного просмотра договорённости внесены в задачу и актуальный раздел.

Ищите детали, без которых коллега будет выбирать решение за вас.

6Подготовьте передачу одного блока

Возьмите небольшой сценарий и приведите материалы к понятному входу для команды.

Соберите рабочий раздел

Выделите актуальные экраны, назовите состояния и отделите варианты. Проверьте компоненты, тексты и материалы для экспорта. Добавьте задачу и состав выпуска.

Заполните карточку

Карточка передачи макета
Задача и пользовательский сценарий:
Ссылка на текущий раздел:
Статус решения и состав выпуска:
Что в этот выпуск не входит:
Компоненты и связь с библиотекой:
Согласованные тексты и изображения:
Примеры данных, которые нельзя считать реальными:
Открытые вопросы и ответственные:
Кто подтвердил доступ и состав решения:
Где сохраняем следующие изменения:
Где и с кем проверяем реализацию:

Попросите коллегу найти решение

Передайте ссылку и карточку человеку, который не участвовал в подготовке. Проверьте, нашёл ли он текущие экраны, понял ли объём и увидел ли неизвестные детали.

В уроке Middle разберёте описание поведения, адаптив и проверку работающей реализации.

Что почитать дальше

  • Using, adapting and creating patternsGOV.UK Service Manual · на английском · бесплатноКак опираться на существующие паттерны и обосновывать изменения решения.
  • Design tokensU.S. Web Design System · на английском · бесплатноКак именованные значения оформления помогают связать макет со стилями в коде.