ГОССТАНДАРТ РОССИИ - Информационная технология ПРОЦЕСС СОЗДАНИЯ ДОКУМЕНТАЦИИ ПОЛЬЗОВАТЕЛЯ ПРОГРАММНОГО СРЕДСТВА

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

Тестирование должно проводиться в машинном зале с использованием бета-версии тестов для ABC; в тестировании должно участвовать по одному представителю от разработчиков программных средств и разработчиков документации (далее — представители).

Тестирование должно проводиться с привлечением четырех типовых пользователей, перечисленных в С.4, выбранных произвольно из персонала ночной смены, эксплуатирующего систему. Каждому из них должны быть даны копии руководства пользователя и справочных текстов для системы ABC с просьбой выполнить ряд действий (перечисленных в плане тестирования).

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

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

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

График работ показан в таблице С.З.

Таблица С.З — График работ

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

Рисунок D.1 — Иерархия аудиторий

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

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

После определения перечня аудиторий для конкретной системы на следующем этапе следует определить задания (tasks), выполняемые каждой аудиторией. Часто данные задания представляют в виде иерархической структуры (см. рисунок D.2).

Рисунок D.2 — Иерархия заданий

На следующем этапе для определенной аудитории в рамках выданных ей заданий определяют перечень ее потребностей в информации (information needs). На основе данного перечня определяют содержание конкретного документа, как показано на рисунке 3.

Рисунок D.3 — Информационные потребности

На данном этапе (но не ранее) следует определить вид (тип) конкретного документа и машинный носитель, на котором он поставляется.

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

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

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

Рисунок D.4 — Общая структура процесса проектирования документирования

Более подробное описание процесса проектирования документации приведено в BS 7649-93 [2].

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

Вчасти терминологии, используемой в документах, необходимо руководствоваться следующими правилами:

a) применять общие и нетехнические термины в соответствии с их определениями, установленными в общих словарях;

b) создавать глоссарии (словники), содержащие:

1) определения всех специфических и неизвестных терминов,

2) виды и определения всех обозначений и сокращений,

3) толкования непривычного использования слов, применение имен существительных в качестве наречий,