Документирование интерфейса

Что это такое?

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

Визуальная спецификация — это документ, который дополняет прототип и описывает логику и принципы, по которым построен интерфейс. Цель спецификации — донести идеи продуктовой команде в максимально понятной и полной форме. Лучше всего это работает, когда используются и текст, и графика.

Human interface guidelines — это документ, который описывает «правила игры», логику платформы. Его задача — поддерживать логическое и визуальное единство большой системы, линейки продуктов или платформы для приложений — всегда, когда разные части разрабатываются разными командами. Такой документ может использоваться внутри большой продуктовой компании или публиковаться для разработчиков сторонних приложений. Примеры HIG: SAP Fiori, ORACLE UX Direct Patterns & Guidelines, Kinect for Windows HIG, iOS HIG, Material Design

Зачем это нужно?

Спецификация может быть более или менее подробной в зависимости от потребностей заказчика и особенностей проекта — где-то нужен pdf-файл на сто страниц, а где-то все решения очевидны из картинок и интерактивных прототипов.

Подробные спецификации нужны для того, чтобы:

  • Объяснить разработчикам и тестировщикам, как должна работать разрабатываемая система. Если какой-то функционал не описан в спецификации, его придумает разработчик, а тестировщик не сможет его проверить.
  • Передать знания о логике проекта графическому дизайнеру.
  • В случае HIG — передать знания о том, как устроена система, проектировщику интерфейсов.
  • Описать негативные сценарии поведения системы, например, ошибки.
  • Сократить время проектирования в случаях, когда поведение проще описать, чем воспроизвести в прототипе.
  • Обучить участников дальнейшего процесса принципам юзабилити, на которых основан проект.

Что написано в документе?

В максимально подробной версии спецификация может быть довольно объемной и включать:

  • концепцию интерфейса, логику расположения элементов на экранах;
  • термины и определения;
  • требования к содержимому отдельных экранов, важные с точки зрения эргономики;
  • поведение форм и интерактивных элементов;
  • принципы графического дизайна, использованные при создании прототипа.

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

Россия
129085, г.Москва, ул. Годовикова д.
9, стр. 2, подъезд 2.1, офис 2.22