3.1.5 Формулировки практичности
Должен быть назван тип интерфейса пользователя, например, строка команд, меню, окна, функциональная клавиша, функция подсказки.
Должны быть определены конкретные знания, которые необходимо усвоить пользователю для применения соответствующего продукта. Например:
- знание соответствующей технической области;
- знание операционной системы;
- знания, получаемые в результате специального обучения;
- знание языков, отличных от языка, на котором написано описание продукта.
Должны быть указаны все естественные языки, на которых написана документация пользователя и описан интерфейс пользователя (включая сообщения об ошибках и видимую информацию), как для самого пакета программ, так и для всех других продуктов, упомянутых в описании данного продукта.
Примечание - Данное требование строже, чем аналогичное требование 6.1.7 ГОСТ Р ИСО 9127 [13], согласно которому указание языка является необязательным.
Если продукт может настраиваться (адаптироваться) пользователем, то должны быть указаны инструментальные средства для проведения такой настройки и условия их применения. Например:
- изменение параметров;
- изменение алгоритмов вычислений;
- назначение функциональных клавиш.
Если техническая защита от нарушения авторских прав может ухудшить практичность описываемого продукта, то в описании продукта должны быть указаны виды и средства такой защиты. Например:
- техническая защита от копирования;
- запрограммированные даты окончания использования продукта;
- интерактивные напоминания об оплате за копии.
В описание продукта может быть внесена информация по эффективности применения продукта и удовлетворению им потребностей пользователя.
Примечание - Такая информация может быть описана в соответствии с рекомендациями, приведенными в ИСО 9241-11 [16].
3.1.6 Формулировки эффективности
В описание продукта может быть включена информация о характере поведения продукта во времени, например времена ответа и оценки производительности для заданных функций при установленных условиях (например, для заданных конфигураций системы и профилей загрузки).
3.1.7 Формулировки сопровождаемости
В описание продукта могут быть внесены формулировки требований (правил) по сопровождению продукта.
3.1.8 Формулировки мобильности (переносимости)
В описание продукта могут быть внесены формулировки требований (правил) по мобильности продукта.
3.2 Документация пользователя
3.2.1 Полнота (completeness)
Документация пользователя должна содержать информацию, необходимую для использования продукта. В документации пользователя должны быть полностью описаны все функции, установленные в описании продукта, и все вызываемые пользователем функции из программы.
Все граничные значения, заданные в описании продукта, должны быть продублированы в документации пользователя.
Если установка (инсталляция) продукта может быть проведена пользователем, то в документацию пользователя должно быть включено руководство по установке продукта, содержащее всю необходимую информацию (см. 3.3.1 а). В руководстве могут быть указаны минимальные и максимальные объемы однократно устанавливаемых файлов.
Если сопровождение продукта может проводиться пользователем, то в документацию пользователя должно быть включено руководство по сопровождению программы, содержащее всю информацию, которая необходима для обеспечения данного вида сопровождения.
3.2.2 Правильность (correctness)
Вся информация в документации пользователя должна быть правильной. Кроме того, представление данной информации не должно содержать неоднозначных толкований и ошибок.
3.2.3 Непротиворечивость (consistency)
Документы, входящие в комплект документации пользователя, не должны противоречить сами себе, друг другу и описанию продукта. Каждый термин должен иметь один и тот же смысл во всех документах.
Примечание - Непротиворечивость программ и данных рассматривается в 3.3.1 d.
3.2.4 Понятность (understandability)
Документация пользователя должна быть понятной для сообщества пользователей, выполняющих указанную рабочую задачу, например посредством использования в ней соответствующим образом подобранных терминов, графических вставок, уточняющих пояснений и путем ссылок на полезные источники информации.
3.2.5 Простота обозрения (ease of overview)
Документация пользователя должна быть достаточно проста для изучения пользователем, чтобы он мог выявить все описываемые в ней взаимосвязи компонентов продукта.
В каждый документ может быть включено оглавление и предметный указатель.
Если документ не поставляется в напечатанном виде, то должна быть определена процедура его распечатки с соответствующего носителя данных.
3.3 Программы и данные
3.3.1 Функциональные возможности
Если установка пакета может быть выполнена пользователем, то при ее проведении должна быть обеспечена возможность успешной установки программ в соответствии с информацией, содержащейся в руководстве по установке. Каждая из необходимых систем, указанных в описании продукта, должна быть пригодной для установки программ.
В процессе установки должно быть определено, могут ли установленные программы функционировать, например путем использования поставленных с программами контрольных примеров или самотестирования с выдачей соответствующих сообщений.
Все функции, указанные в документации пользователя, должны выполняться в виде, заданном б документации пользователя, на соответствующих средствах, с соответствующими характеристиками и данными, в рамках граничных значений, заданных там же.
Примечание - Так как все функции, указанные в описании продукта, должны быть отражены в документации пользователя, из этого следует, что данные функции так же должны выполняться.
Программы и данные должны соответствовать всем обязательным формулировкам, приведенным в описании продукта и документации пользователя. Функции должны выполняться методом, соответствующим рабочей задаче. В частности, программы и данные должны удовлетворять всем требованиям из любого нормативного документа, на который дана ссылка в описании продукта.
Программы и данные не должны противоречить сами себе, а также описанию продукта и документации пользователя. Каждый термин везде должен иметь один и тот же смысл.
Управление работой программы со стороны пользователя и соответствующая реакция программы (например, сообщения, выходные экранные форматы и печатные отчеты) должны быть единообразно структурированы.