Что разберём
1Покажите, какое решение собирать
Разработчику нужно найти актуальное решение и понять его статус.
Выделите точку входа
Дайте ссылку на нужный экран или раздел файла. Рядом укажите задачу, состав текущего выпуска и статус решения. Проверьте, что коллега может открыть ссылку.
Если доступ зависит от учётной записи, уточните его до начала работы. Скриншот можно приложить для обсуждения; для реализации понадобится доступ к согласованным материалам.
Отделите рабочее решение от вариантов
Сохраните черновики для истории, но обозначьте их статус. Если рядом лежат несколько версий без пояснений, разработчик будет выбирать между ними.
Сравните:
Ссылка на весь файл
Вот макеты корзины. Последний вариант где-то справа.
Нужно искать экран и выяснять, какой из вариантов согласован.
Вход в текущую задачу
Собираем блок получения из раздела для разработки. Черновики находятся в архиве. Выбор города в этот выпуск не входит.
Видно, где начать и какой объём использовать. Само согласование ещё нужно проверить с командой.
Назовите неизвестное
Отметьте вопросы, которые ещё обсуждаются. Назначьте с командой человека, который даст ответ. Не превращайте предположение о работе системы в готовое требование.
Например:
Срок получения зависит от склада. Пока разработчик проверяет источник данных, подпишите срок как пример и отметьте вопрос о доступности расчёта.
2Организуйте файл вокруг задачи
Понятные названия помогают искать нужную часть решения и обсуждать изменения.
Назовите экраны по сценарию
Используйте названия, которые понимает команда: получение заказа, ошибка расчёта, подтверждение выбора. Сохраняйте последовательность сценария и обозначьте варианты состояния.
Например:
В разделе текущей задачи лежат экраны выбора получения, загрузки срока и ошибки. В архиве лежат варианты, которые команда рассматривала раньше.
Проверьте слои и группы
Назовите значимые группы по назначению: список способов, пояснение срока, действие продолжения. Уберите случайные дубликаты из рабочего раздела и проверьте скрытые элементы.
Команде не нужен отдельный словарь для каждого декоративного слоя. Договоритесь о названиях, которые помогают найти компонент, состояние или материал для экспорта.
Проверьте статус материалов
Раздел подписан «В разработку», связан с задачей; команда согласовала состав выпуска.
Это актуальное решение для указанного выпуска. Проверьте доступ и оставшиеся вопросы.
Рядом лежит вариант другого способа выбора, помеченный как отклонённый.
Это материал истории. Его нельзя включать в реализацию как часть текущего решения.
Доступность срока зависит от ответа команды сервера; в макете стоит пример.
Это открытый вопрос. Уточните источник и возможные ответы до обещания покупателю.
Экран из прошлого выпуска лежит в архиве с датой и пояснением.
Архив помогает понять историю, но не задаёт текущую реализацию.
Согласованный экран ошибки связан с тем же выпуском, что и основной экран.
Это часть текущего решения. Основной сценарий и ошибка должны иметь понятную связь.
У нового значка нет утверждённого назначения, его обсуждают в комментариях.
Сначала согласуйте назначение и роль. Наличие слоя не означает, что значок нужно собирать.
3Сверьте компоненты с библиотекой
Перед передачей проверьте, из каких элементов собран макет и что команда уже использует в продукте.
Используйте согласованные элементы
Проверьте кнопки, поля и выбор способа получения. Если библиотека содержит подходящий компонент, возьмите его актуальный вариант. Уточните соответствие компоненту в коде.
GOV.UK в руководстве о паттернах советует начинать с существующих решений и менять их, когда исследование показывает, что они не подходят. Для вашего продукта исходной точкой будет библиотека команды.
Проверьте свойства и стили
Сверьте состояние, размер, подписи и применённые стили. Если элемент выглядит как компонент, но собран вручную, отметьте отличие и обсудите, как его реализовать.
USWDS объясняет дизайн-токены как ограниченный набор именованных значений для оформления. При передаче укажите согласованный стиль или токен, если команда уже связывает его с кодом.
Запишите обоснованные отличия
Если нужен новый вариант, объясните задачу и покажите отличие от существующего. Уточните с дизайнером библиотеки и разработчиком, кто проверит его поведение.
Название токена само по себе не подтверждает совпадение макета и продукта. Попросите разработчика сверить связь с текущей реализацией.
4Добавьте контекст и нужные материалы
Макет должен помогать понять задачу, содержание и назначение элементов.
Опишите место в сценарии
Коротко назовите, откуда покупатель приходит в блок и куда идёт после выбора. Дайте ссылку на задачу и соседние экраны, если они влияют на реализацию.
| Материал | Что пояснить |
|---|---|
| Текущий макет | Какой раздел и выпуск собирать |
| Сценарий | Что человек делает до и после этого экрана |
| Компоненты | Какие элементы уже есть в библиотеке и коде |
| Открытые вопросы | Что неизвестно и кто уточняет |
| Изображения | Какие файлы нужны и как они используются |
Проверьте содержание
Замените случайные подписи согласованным текстом. Если содержание ещё готовит редактор, обозначьте это и договоритесь, где появится окончательная версия.
Покажите правдоподобный длинный вариант: название пункта получения, пояснение срока или сообщение об ошибке. Это поможет заметить ограничения места до реализации.
Подготовьте изображения
С разработчиком уточните формат, размеры и способ использования файлов. Назовите материалы по назначению и проверьте, что экспорт соответствует выбранному элементу.
Укажите, несёт ли изображение смысл или служит украшением. Для смыслового изображения согласуйте текстовое описание; для декоративного обсудите исключение из чтения скринридером.
5Пройдите материалы вместе с разработчиком
Совместный просмотр помогает обнаружить вопросы до подробной сборки.
Покажите один сценарий
Откройте точку входа и пройдите выбор получения. Покажите состав выпуска, компоненты и неизвестные детали. Попросите коллегу назвать, что он начнёт собирать.
Сохраните ответы в задаче
После обсуждения обновите подписи и материалы. Свяжите решение со своей задачей. Если договорённость осталась только в разговоре, другой участник может её не найти.
Уточните, кто ответит на новые вопросы во время разработки. Обсудите, где будете проверять работающий вариант; подготовка файла не завершает совместную работу.
Проверьте готовность передачи
Есть ссылка на текущий раздел, доступ проверен, объём согласован, вопросы с ответственными перечислены.
Есть понятная основа для начала. Значимые открытые вопросы могут потребовать ответа до отдельных частей работы.
Все экраны подписаны «Финал», но команда не выбирала актуальный вариант.
Уточните выбор и статус. Одинаковые названия не заменяют договорённость.
Срок получения в примере подписан как реальные данные, хотя источник пока неизвестен.
Обозначьте пример и разберите источник данных. Иначе реализация может обещать недоступное.
Новый вариант компонента отмечен, отличие описано, его проверяет назначенный коллега.
Отличие видно и есть ответственный. Уточните, какие части можно собирать до результата проверки.
Разработчик не открывает ссылку, поэтому получает только снимок основного экрана.
Наладьте доступ к нужным материалам. Снимок может помочь обсуждению, но не раскрывает всё решение.
После совместного просмотра договорённости внесены в задачу и актуальный раздел.
Другой участник сможет найти решение. При следующем изменении материалы нужно обновить.
6Подготовьте передачу одного блока
Возьмите небольшой сценарий и приведите материалы к понятному входу для команды.
Соберите рабочий раздел
Выделите актуальные экраны, назовите состояния и отделите варианты. Проверьте компоненты, тексты и материалы для экспорта. Добавьте задачу и состав выпуска.
Заполните карточку
Задача и пользовательский сценарий: Ссылка на текущий раздел: Статус решения и состав выпуска: Что в этот выпуск не входит: Компоненты и связь с библиотекой: Согласованные тексты и изображения: Примеры данных, которые нельзя считать реальными: Открытые вопросы и ответственные: Кто подтвердил доступ и состав решения: Где сохраняем следующие изменения: Где и с кем проверяем реализацию:
Попросите коллегу найти решение
Передайте ссылку и карточку человеку, который не участвовал в подготовке. Проверьте, нашёл ли он текущие экраны, понял ли объём и увидел ли неизвестные детали.
В уроке Middle разберёте описание поведения, адаптив и проверку работающей реализации.
Что почитать дальше
- Using, adapting and creating patternsКак опираться на существующие паттерны и обосновывать изменения решения.
- Design tokensКак именованные значения оформления помогают связать макет со стилями в коде.