Глава 12

Принципы, инструкции

и руководства по стилю

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

Многие компании тратят значительные усилия, разрабатывая внутренние руково­дства по стилю ПИ, чтобы компенсировать недостатки общих руководств, хотя боль­шая часть из этих усилий не приносит желаемых результатов в отношении практич­ности, интеграции и согласованности применительно к продуктам, разрабатываемым независимыми бригадами. Следствием данной проблемы являются рост расходов на обучение, снижение продуктивности и чувство глубокого разочарования у пользова­телей, проектировщиков, разработчиков и менеджеров.

В разделах данной главы рассматриваются следующие вопросы.

• Достойные внимания принципы, стандарты, инструкции и руководства по стилю.

• Некоторые определения.

• Предписывающие руководства по стилю.

• Предписывающие решения для общих проблем.

• Разработка предписывающих руководств по стилю.

• Точка зрения руководства.

• Полезные методы.

• Принципы и инструкции для проекта.

В данной главе рассматривается вопрос о том, что необходимо знать проектной бригаде о выборе и использовании проектных принципов и инструкций. Далее указываются различия в понятиях принципов, инструкций и стандартов. Затем будут приведены определение руководства по стилю ПИ, характеристики эффективных руководств по стилю и методам их разработки применительно к ПИ продукта, информационных и визуальных объектов, а также других артефактов. Применение ориентированных на пользователей методов разработки рекомендуется при разработке ру­ководств по стилю только в тех случаях, когда пользователи входят в проектную бригаду.

В главе подробно описываются предписывающие руководства по стилю. Предлагаемые методы их разработки рассматриваются с технической и управленческой точ­ки зрения. Приводятся весьма специфические примеры предписывающего стиля для использования элементов GUI-,WUI- иHUI-интерфейса, функциональных возможностей, согласованности и интеграции. Анализируются процессы разработки предпи­сывающего руководства по стилю, а также процессы его использования разработчи­ками и руководителями (рис. 12.1).

Достойные внимания принципы,

стандарты, инструкции и руководства

по стилю

Существует ряд руководств по стилю ПИ, созданных поставщиками платформ ОС и/или броузеров. Эти руководства по стилю для платформ носят общий характер в том смысле, что не содержат указаний по достижению специфических и согласован­ных результатов высокого уровня для какого-либо приложения или пакета приложе­ний, либо для разнородной совокупности приложений, функционирующих на данной платформе. Это утверждение можно проиллюстрировать следующими примерами.

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

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

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

Компании тратят значительные усилия, разрабатывая внутренние руководства по стилю ПИ, чтобы компенсировать недостатки общих руководств. Многие из этих уси­лий не приносят желаемых результатов в отношении практичности, интеграции и согласованности применительно к продуктам, разрабатываемым независимыми брига­дами. Следствием данной проблемы являются рост расходов на обучение, снижение продуктивности и чувство глубокого разочарования у пользователей, проектировщи­ков, разработчиков и менеджеров.

Полезное правило. Исходя из лучших намерений, мы остаемся непоследова­тельными (даже по отношению к себе). Цель руководства по стилю состоит как раз в том, чтобы помочь нам быть последовательными.

Некоторые определения

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

Принципы. Принципы— это общие указания по проектированию, которые носят качественный характер и относятся к категории утверждений, которых полез­но придерживаться. Пример часто провозглашаемого принципа проектирования — стремление к простоте. Достижение простоты всегда в центре внимания пользовате­лей, разработчиков, экспертов по оценке и других специалистов, так или иначе свя­занных с программным обеспечением. Оценки фактического соответствия этому принципу трудно поддаются непосредственному измерению, субъективны и являются вопросом меры, с которой к ним нужно подходить. Можно без труда составить длин­ный перечень принципов, которые очень трудно использовать на практике.

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

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

Инструкции. Инструкция (или руководящее указание) — это правило проектирования, которое полезно при реализации и легко поддается измерению в терминах соответствия. Вот пример подобной инструкции: "Используйте красный (RGB 255,0,0) цвет для текста предупреждающего сообщения, отображаемого на белом фоне." (Цве­товая модель RGB (сокр. от Red-Green-Blue — "красный", "зеленый", "синий") — это основная палитра, используемая в программировании и компьютерной графике. — Прим. ред.)

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

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

Стандарты. Стандарты — это руководящие указания, которые отражаются не­посредственно в ПИ операционной системы или которых придерживается большое количество ведущих организаций отрасли при разработке приложений. Стандарты самого высокого уровня разрабатываются организациями наподобие Международной организации по стандартизации (International Standardization Organization— ISO). Пример стандарта ПИ, ориентированного на определенную платформу, — использо­вание термина Edit (Правка) для наименования меню, содержащего команды работы с буфером обмена.

Полезное правило. Всегда следуйте отраслевым стандартам, если только у вас нет твердой, основанной на мнении пользователей уверенности в целесообразно­сти отклонений.

Руководство по стилю. Руководство по стилю ПИ — это концептуальная и весьма высокоуровневая спецификация, которая описывает общий внешний вид, по­ведение и пользовательское взаимодействие, а уникальные подробности, касающиеся ПИ приложения, опускаются.

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

Руководство по стилю можно представить себе как высокоуровневый обзор или руководство пользователя, описывающее способ использования продукта или пакета приложений. Руководство по стилю ПИ содержит принципы, инструкции и стандар , применяемые при проектировании продукта.

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

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

Проблема. Традиционные руководства по стилю ПИ носят описательный ха­рактер (т.е. дается общее указание без конкретизации подсказываемой директивы). Инструкции описательного типа рекомендуют разработчику ПИ использовать окна в различных целях, например, для отображения объектов или действий. Однако руководство описательного типа слабо конкретизирует инструкции или директивы в отношении того, как именно отображать объект или действие внутри окна или желательное поведение при взаимодействии.

Разработчик должен выделить конкретные детали, полностью прочитав руково­дство по стилю, сформировать желательный стиль, а затем определить конкретные детали приложения, выходящие за рамки базисных свойств ПИ. Типичная сложность стиля для ПИ, который проектная бригада должна строить, исходя из следующих составляющих, показана на рис. 12.2.

• Базовые компоненты ПИ (стандартные элементы управления).

• Пользовательские элементы управления или методы для конкретных нужд приложения (узоры из "хлебных крошек"). ("Хлебные крошки" — специально встраиваемые в программу отладочные операторы, служащие путеводной нитью для поиска причин аномального поведения программы при отладке — как хлебные крошки в сказке братьев Гримм, где герои блуждали по лесу — Прим. ред.)

• Интеграция конкретных элементов ПИ (расположение списков на страницах).

Учитывая огромное количество деталей, связанных с прикладным уровнем ПИ и способом использования элементов управления ПИ, не удивительно, что разные раз­работчики, которые трудятся в одной и той же предметной области, используют одну и ту же описательную информацию для достижения совершенно различных результа­тов. Самый существенный недостаток описательных руководств по стилю заключает­ся в том, что для них требуется субъективная интерпретация соответствия.

Современные стили ПИ. Даже несмотря на то, что GUI-, WUI- и HUI-стили хорошо известны в индустрии программных средств, некоторые предприятия по-прежнему продолжают переносить централизованные приложения в эти стили. Кроме того, многие новые приложения создаются разработчиками с небольшим опы­том в этих технологиях и проектировании ПИ. Современных руководств по стилю недостаточно для того, чтобы помочь неопытным разработчикам избежать распро­страненных ловушек, которые ведут к непрактичным приложениям и интерфейсам. Помимо этого, традиционные руководства по стилю не помогают новым разработчи­кам в использовании возможностей, присущих современным стилям.

На что обращать внимание. Разработчики приложений обращают особое внимание на использование компонент ПИ для получения надлежащего эффекта и гарантию того, что прикладной уровень ПИ отличается практичностью и внутренней согласованностью. Разработчики GUI-, WUI- и HUI-ориентированных приложений не сосредотачиваются на разработке компонент ПИ для представления внешнего вида и поведения, если только это не является совершенно необходимым.

Разработчики ПИ-ориентированных приложений концентрируют свое внимание на следующих вопросах.

• Надлежащее использование стилей ПИ (элементы управления, списки, меню, поля и т.д.).

• Прикладной ПИ (предполагаемая пользовательская модель, установка, пове­дение рабочего стола, используемые особенности ПИ и предметной области, объектные модели, модели представления, модели поддержки пользователей, командные модели, модели потока задач, эффективное использование аппаратного обеспечения и т.д.).

• Практичность (избежание распространенных проблем, например, слишком большого количества экранов/шагов работы).

• Согласованность (общность между приложениями, выходящая за рамки базовых свойств ПИ).

• Интеграция (использование непосредственного манипулирования, буфера обмена и т.д.).

Трудности. Основная трудность для проектной бригады состоит в том, чтобы выйти общий язык с пользователями и разработчиками. Другая трудность заключает­ся в том, чтобы предвидеть и избежать распространенных проблем, которые касают­ся ПИ – ориентированных приложений.

Учитывая огромное количество деталей, связанных с прикладным уровнем ПИ и способом использования элементов управления ПИ, не удивительно, что разные раз­работчики, работающие в одной и той же предметной области, используют одну и ту же описательную информацию для достижения совершенна различных результатов. Здесь никоим образом не рассматриваются целиком оси пространства компонент пользовательского интерфейса (рис. 12.3). Как видно из рисунка, стиль ПИ и при­кладной стиль ПИ влияют на достигнутый уровень практичности и согласованности.

Предписывающие руководства по стилю

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

Предписывающее руководство по стилю дает точные и основанные на опыте проектные инструкции, направленные на конкретные проблемы или достижение конкретных результатов. Предписывающее руководство по стилю обращается к обеим осям пространства компонент ПИ (рис. 12.4) и предлагает решение многих проблем, свойственных руководствам по стилю и представляющих собой как разработки поставщиков ОС, так и внутрифирменные разработки. Использование руководящих указаний приводит к созданию практичных, интегрированных и согласованных продуктов. Инструкции выступают в форме правил использования элементов управления ПИ, проектных решений и применения прикладных элементов ПИ или методов, ко­торые способствуют созданию согласованных и интегрированных приложений.

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

Рамки предписывающих руководств по стилю достаточно широки, чтобы давать результаты по использованию ПИ, характеристикам предметной области, ПИ, согла­сованности и интеграции. Используемое до разработки предписывающее руководство по стилю помогает проектировщикам достигнуть конкретных результатов. Подобный подход применяется после попытки обеспечить корректные инструкции для прило­жения, которое не удовлетворяет предполагаемым целям или испытывает проблемы с практичностью. Критический фактор успеха предписывающего руководства по стилю состоит в объективной и поддающейся проверке соответствия требованиям.

Полезное правило. Включите все основные проектные стереотипы ПИ для поведения, внешнего вида и пользовательского взаимодействия в предписываю­щее руководство по стилю.

Пример для списков и таблиц. Рассмотрим пример предписывающей модели для простого списка объектов, отображаемых в окне Web – броузера, где про­стота определяется объемом набора действий, выполнение которых возможно над списком или его элементами (см. рис. 12.4).

Ниже приводится подмножество возможных предписывающих инструкций.

• Используйте таблицу для отображения списка объектов и данных по табуляции.

  • Для ясности поместите заголовок так, чтобы он был выровнен по левому краю над таблицей.

  • Поля, которые управляют содержимым таблицы, отображаются над табли­цей и подзаголовком.

• Таблица выравнивается по центру страницы и окружена свободным местом.

  • Заголовок первого столбца выровнен по левому краю.

  • Заголовки других столбцов выровнены по центру столбца.

  • Текстовая информация внутри столбца выровнена по левому краю.

  • • Числовая информация внутри столбца выровнена по правому краю.

• Использование цвета.

• В строке заголовка текст отображается белым цветом на темно-синем фоне (#336699).

• За исключением ссылок текст в первой строке отображается черным цветом на белом фоне.

• Остальные строки отображаются как черный текст на светло-синем фоне (#9999FF0).

• Между столбцами отображается белая разделительная линия.

• Команды доступа.

  • Команда Open (Открыть) используется по умолчанию для элементов списка посредством нажатия клавиши <Enter> (одиночного щелчка мышью).

  • Для объекта List (Список) и объектов-элементов списка предусмотрено всплывающее меню.

  • При использовании кнопок для набора команд работы со списком они группируются под списком и затеняются, если их использование запрещено.

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

Полезное правило. Представляйте себе предписывающие инструкции как лучшие "ингредиенты" "рецепта" ПИ.

Пример ДЛЯ объекта. Для многих объектов предметной области также не­обходимо предписывающее руководство. В качестве примера рассмотрим Web-ориентированное приложение, для объекта которого используется метафора реальной записной книжки в противоположность приложениям типа записной книжки с тра­диционным ПИ.

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

• Индексные вкладки отображаются вдоль верхнего края записной книжки.

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

• Какие-либо младшие (не основные) вкладки не используются.

• Какое-либо визуальное связывание в нижней части записной книжки не используется.

• Записная книжка выровнена по центру страницы и окружена свободным местом.

• Чтобы вкладки были одинакового размера, для их обозначения используйте краткие термины, аббревиатуры или пиктограммы (расположенные в порядке предпочтения).

• На одной вкладке размещается одна страница информации.

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