ISO/IEC 26514:2008
Системная и программная инженерия. Требования к проектировщикам и разработчикам пользовательской документации.

Стандартный №

ISO/IEC 26514:2008

Дата публикации

2008

Разместил

International Organization for Standardization (ISO)

Последняя версия

ISO/IEC 26514:2008

сфера применения

В этом разделе представлены область применения, цель, организация и возможные варианты использования настоящего международного стандарта. Настоящий международный стандарт поддерживает интерес пользователей программного обеспечения к единообразной, полной, точной и полезной документации. Он включает оба подхода к стандартизации: а) стандарты процессов, которые определяют способ разработки продуктов документации; и b) стандарты документации на продукцию, которые определяют характеристики и функциональные требования документации. Первая часть настоящего международного стандарта охватывает процесс пользовательской документации для проектировщиков и разработчиков документации. В нем описывается, как определить, какая информация нужна пользователям, как определить способ представления этой информации пользователям, а также как подготовить информацию и сделать ее доступной. Он не ограничивается этапом проектирования и разработки жизненного цикла, но включает в себя действия на протяжении всего процесса управления информацией и документирования. Вторая часть настоящего международного стандарта устанавливает минимальные требования к структуре, информативности и формату пользовательской документации, включая как печатные, так и экранные документы, используемые в рабочей среде пользователями систем, содержащих программное обеспечение. Это относится к печатным руководствам пользователя, интерактивной справке, учебным пособиям и справочной документации для пользователей. Настоящий международный стандарт не поощряет и не препятствует использованию печатных или электронных (экранных) носителей для документации, а также конкретных инструментов или методологий разработки документации или управления ею. Настоящий международный стандарт может быть полезен при разработке следующих типов документации, хотя он не охватывает все их аспекты: 　——документация продуктов, отличных от программного обеспечения; ~ мультимедийные системы с использованием анимации, видео и звука; ~ пакеты компьютерного обучения (КПТ) и материалы специализированных курсов, предназначенные в первую очередь для использования в официальных программах обучения; ~ документация, предназначенная для установщиков, операторов компьютеров или системных администраторов, не являющихся конечными пользователями; ~ эксплуатационная документация, описывающая внутреннюю работу системного программного обеспечения; ~ документация, встроенная в сам пользовательский интерфейс. специалисты: ~ информационные дизайнеры и архитекторы, планирующие структуру и формат продуктов документации в комплекте документации; ~ специалисты по удобству использования и бизнес-аналитики, которые определяют задачи, которые предполагаемые пользователи будут выполнять с помощью программного обеспечения: ~ те, кто разрабатывает и редактирует письменный контент для пользовательской документации; ~ графические дизайнеры с опытом работы в электронных СМИ; ~ дизайнеры пользовательского интерфейса и эксперты по эргономике работают вместе над дизайном представления документации на экране. С настоящим международным стандартом могут также ознакомиться лица, занимающие другие роли и интересы в процессе документирования: ~ менеджеры процесса разработки программного обеспечения или процесса документирования; ~ приобретатели документации, подготовленной поставщиками; ~ юзабилити-тестеры, рецензенты документации, профильные эксперты; ~ разработчики инструментов для создания экранной документации; ~ Эксперты по человеческому фактору, которые определяют принципы, позволяющие сделать документацию более доступной и простой в использовании. Настоящий международный стандарт предназначен для использования во всех типах организаций, независимо от наличия специального отдела документации, и может использоваться в качестве основы для местных стандартов и процедур. Предполагается, что читатели имеют опыт или знания в области разработки программного обеспечения или процессов разработки документации. Пользователи настоящего международного стандарта должны принять руководство по стилю для использования в своих организациях в дополнение к руководству, представленному в приложениях к настоящему международному стандарту, или принять признанное в отрасли руководство по стилю. Приложение A содержит рекомендации по содержанию руководства по стилю, а Приложения B и C содержат рекомендации по стилю.

ISO/IEC 26514:2008 Ссылочный документ

• ISO/IEC 12207:2008 Системная и программная инженерия. Процессы жизненного цикла программного обеспечения.
• ISO/IEC 15288:2008 Системная и программная инженерия. Процессы жизненного цикла системы.

ISO/IEC 26514:2008 История

• 2008 ISO/IEC 26514:2008 Системная и программная инженерия. Требования к проектировщикам и разработчикам пользовательской документации.