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

ГОСТ Р ИСО/МЭК 12207-99 Информационная технология. Процессы жизненного цикла программных средств

ИСО 216-75 [1] Оригинал международного стандарта — во ВНИИКИ Госстандарта России. Бумага писчая и классы печатных материалов. Размеры обрезки. Серии А и В.

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

4.1 А4, А5: Размеры сторон листа 210×297 мм и 148?×210 мм соответственно (см. ИСО 216, ГОСТ 2.301).

4.2 заказчик(acquirer): Организация, которая приобретает или получает систему, программный продукт или программную услугу от поставщика (3.1 ГОСТ Р ИСО/МЭК 12207).

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

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

Примечание — Одна и та же программная документация может использоваться различными аудиториями (например, руководством, операторами по вводу исходных данных или сопроводителями).

4.4 изучение аудитории(audience research): Планируемый процесс опроса потенциальных пользователей и анализа его индивидуальных и интегральных результатов.

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

4.5 В5: Размеры сторон листа 176×250 мм (см. ИСО 216).

4.6 вспомогательный материал(back matter): Материал, содержащийся в конце книги или руководства, например, тематический указатель.

4.7 фотошаблоны(camera-ready originals):Набор изображений на бумаге, фотопленке или другом носителе, с которого может быть сделана фотокопия, где каждое изображение содержит все необходимые текстовые и графические элементы одной страницы печатного документа, скомпонованные должным образом.

4.8 дата пересмотра(cut-off date): Дата, по истечении которой все изменения, внесенные впрограммные средства, описываются в новой редакции документации, более верной по сравнению с действующей.

4.9 номенклатура поставки(deliverables): Объекты (элементы, изделия и т. д.), поставляемые заказчику по условиям договора.

4.10 документ(document): См. элемент документации (4.26).

4.11 документация(documentation): Печатные руководства пользователя, диалоговая (оперативная) документация и справочный текст («хелпы»), описывающие как пользоваться программным продуктом.

4.12 персонал разработчиков документации(documentation development staff): Весь персонал, привлекаемый на любом этапе планирования, написания, редактирования и выпуска документации.

Примечание — Данный термин охватывает коллектив авторов, оформителей, иллюстраторов и администрации проекта.

4.13 план документирования(documentation plan): Документ, в котором излагаются необходимые элементы проекта документирования.

4.14 документатор(documenter): Сторона, создающая документацию.

Примечание — В настоящем стандарте не используют термин разработчик (developer) (в смысле 3.8 по ГОСТ Р ИСО/МЭК 12207), так как в случае документирования разработчик программного средства часто является заказчиком документации, и использование термина разработчик может привести к разночтению. Поэтому используют термин документатор.

4.15 электронная копия(electronic copy): Компьютерный диск или другой машиночитаемый носитель информации, содержащий файл или файлы, с которого(ых) может быть распечатан документ.

4.16 n-штрих(en dash): Штрих, имеющий такую же ширину, как и строчная буква «n».

4.17 концевые примечания(endnotes): Примечания, собранные в конце главы или документа.

4.18 страница-раскладка(foldout): Страница, сложенная так, что ее задняя часть шире передней (немного превышает основной формат), которую можно развернуть.

4.19 нижний колонтитул(footer): Справочная(ые) строка(и) под текстом страницы, указывающая(ие) на ее содержание (например, номер страницы).