ČSN ISO/IEC 15910 (369039) Zrušená norma

Anotace obsahu normy

Norma ISO/IEC 15910 Informační technologie - Proces uživatelské dokumentace softwaru byla připravena společnou technickou komisí ISO/IEC JTC 1 Informační technologie, subkomisí SC 7, Softwarové inženýrství. Tato norma byla převzata do souboru ČSN překladem.
Norma bezprostředně navazuje na ISO/IEC 12207 - Procesy v životním cyklu softwaru, která definuje tři druhy procesů: primární, podpůrné a organizační. Proces dokumentování patří mezi procesy podpůrné.
Tato norma rozpracovává proces dokumentování na základě myšlenky, že neustále se zvyšující rozsah a složitost počítačových aplikací činí nezbytnou dostupnost úplné, přesné a pochopitelné dokumentace pro ty, kteří software používají. Tato mezinárodní norma poskytuje prostředek pro dosažení tohoto cíle specifikováním těch činností (co má být uděláno a kdo to má udělat), které mohou ovlivnit jakost uživatelské dokumentace softwaru. Pro jakostní tvorbu softwarové dokumentace se má na ni hledět jako na nedílnou součást procesu tvorby softwaru, ale zároveň norma předpokládá, že její tvorbu budou zajišťovat specialisté - dokumentátoři.
Hlavní činností, kterou norma popisuje, je vytvoření vyčerpávajícího plánu pro vývoj dokumentování a jeho následnou realizaci, řízení a kontrolu.
Norma obsahuje přes 50 definicí, které se vyskytují v této oblasti a navazuje na definice z oblastí informační technologie, obecné jakosti a typografie. Norma předpokládá, že bude používán ve všech případech tvorby dokumentace systém managementu jakosti. Dále předpokládá, že bude možno její postupy upravovat podle konkrétních podmínek příslušné organizace. Norma je určena pro každého, kdo vytváří nebo nakupuje dokumentaci.
Norma obsahuje základní kapitolu (osmou), která rozpracovává požadavky na proces dokumentování od opatření zdrojových materiálů přes plán dokumentování, jeho přezkoumání, testování použitelnosti dokumentace až po změnové řízení a údržbu vydaného dokumentu. Dále je zde podrobný popis specifikace stylu určený pro zpracování papírové i elektronické dokumentace (na tyto dvě základní části je tato kapitola rozdělena).
Aby byla norma co nejvíce srozumitelná, obsahuje informativní přílohy A až H, které podrobně popisují příklady (například vzorový plán dokumentování, odkazy na tuto normu ve smlouvě mezi kupujícím a prodávajícím dokumentaci, vzájemné vztahy mezi cílovou skupinou uživatelů a úlohami, odhadování doby zpracování dokumentace, posuzování plánu dokumentování a vzorovou specifikaci stylu). Norma je překladem anglického originálu a má 54 stránek.