ГОСТ Р ИСО/МЭК 15910-2002

ГОСТ Р И С О /М Э К 15910-2002


                                          ГОСУДАРСТВЕННЫЙ              СТАНДАРТ       РОССИЙСКОЙ     ФЕДЕРАЦИИ




                                                                Информационная технология

                                                                 П Р О Ц Е С С С О ЗД А Н И Я
                                                        Д О К У М Е Н Т А Ц И И П О Л Ь ЗО В А Т Е Л Я
                                                            П Р О Г Р А М М Н О Г О СРЕДС ТВ А


                                                                         Издание официальное
                                        БЗ 1-2002/376




                                                                        ГОССТАНДАРТ РОССИИ
                                                                             Москва




строительство промышленных сооружений

ГОСТ Р ИСО/МЭК 15910-2002

                                       Предисловие

     1 РАЗРАБОТАН И ВНЕСЕН Всероссийским научно-исследовательским институтом стандартиза­
ции (ВНИИстаидарт) Госстандарта России

    2 ПРИНЯТ И ВВЕДЕН В ДЕЙСТВИЕ Постановлением Госстандарта России от 25 июня 2002 г.
№ 249-ст

     3 Настоящий стандарт содержит полный аутеш ичный текст международного стандарта
И СО /М Э К 15910—99 «Информационная технология. Процесс создания документации пользователя
программного средства»

     4 ВВЕДЕН ВПЕРВЫЕ




                                                       © И ПК Издательство стандартов. 2002

     Настоящий стандарт не может быть полностью или частично воспроизведен, тиражирован и
распространен в качестве официального издания без разрешения Госстандарта России
II

ГОСТ Р ИСО/М ЭК 15910-2002

                                                                                 Содержание

1 Область п р и м ен ен и я.......................................................................................................................................                1
2 С оответстви е....................................................................................................................................................              1
3 Нормативные с с ы л к и ...................................................................................                                                                     1
4 О пределения.....................................................................................................................................................               2
5 Управление к ач еством ...................................................................................................................................                      4
6 А дап тац и я..........................................................................................................................................................         5
7 Ц е л и ....................................................................................................................................................................    5
8 Т реб овани я........................................................................................................................................................           5
   8.1 Процесс документирования....................................................................................................................                               5
   8.2 Содержание спецификации с т и л я .........................................................................................................                               12
Приложение А Перекрестные ссылки с ГОСТ Р ИСО/М ЭК 12207 ....................................................                                                                    19
Приложение В Использование настоящего стандарта в д о го в о р е...........................................................                                                      19
   В.1 Общие п о л о ж ен и я....................................................................................................................................                19
   В.2 Образец раздела д о го в о р а........................................................................................................................                    19
   B. З Праклшеское применение настоящего стан д ар та.........................................................................                                                  20
Приложение С Образец плана документирования. Документация пользователя для системы ЛВС
                       — административного управления магнитными л е н т а м и ............................................                                                      20
   C . 1 В ведение.................................................................................................................................................              20
   СДОбчаетьприменения и о гран и ч ен и я....................................................................................................                                   20
   С.З Оформление и стиль о п и с а н и я .............................................................................................................                          20
   С.4 А удитория...................................................................................................................................................             21
   С. 5 Проект содержания докум ентации.......................................................................................................                                   21
   С. 6 Номенклатура п о ст ав к и ...............................................................................                                                               21
   С.7 Авторские п р а в а ........................................................................................................................................              21
   С.8 Транспортирование..................................................................................................................................                       21
   С.9 Процесс разработки и к о н т р о л ь ............................................................................................................                         21
   С. 10 Т ираж ирование.......................................................................................................................................                  21
   С.11 П роектанты ..............................................................................................................................................               22
   С. 12 Р е с у р с ы ....................................................................................................................................................      22
   С. 13 Тестирование на практичность........................................................................................................                                    22
   С. 14 График р а б о т .........................................................................................................................................              23
Приложение D Отношения между аудиториями, выданными заданиями, бумажной и диалого­
                        вой докум ентацией...............................................................................................................                        23
Приложение Е Рекомендации по написанию на английском языке документации, подлежащей
                        последующему п ер ево д у .......................................................................................................                        26
   E.I Общие положен и я ....................................................................................................................................                    26
   Е.2 Т ерм инология............................................................................................................................................                26
   Е.З Стиль п ер е в о д а.........................................................................................................................................             26
   Е.4 Физические ф а к т о р ы ..............................................................................................................................                   27
   Е.З Диалоговая и н ф о р м ац и я.................................................                                                                                            27
   E. 6 Культурные ф а к т о р ы ............................................................................... ......................................                          27
Приложение F Оценка п р о е к т а ......................................................................................................................                         28
   F . 1 Общие п о л о ж е н и я.................................................................................................................................                28
   F.2 Поминутный и почасовой м е т о д ы ......................................................................................................                                 28
   F.3 Метод нисходящего проектирования..................................................................................................                                        29
Приложение U Оценка плана докум ентирования....................................................................................                                                  30
Приложение Н Образец спецификации с т и л я ..........................................................................................                                           30
   Н.1 Общие положения ......................................                                                                                                                    30
   Н.2 Элементы с т и л я .......................................................................................................................................                30
   Н.З Спецификация у к азател я......................................................................................................................                           34
Б иблиограф ия.......................................................................................................................................................            36
Тематический у к азател ь.....................................................................................................................................                   37
                                                                                                                                                                                 III

ГОСТ Р ИСО/МЭК 15910-2002

                                              Введение

      Существующие стандарты можно отнести к двум основным типам:
      a) стандарты на продукцию, определяющие ее характеристики и требования к ней;
      b ) стандарты на процессы, определяющие конкретные методы создания продукции.
      Возрастающий масштаб применения программных средств и их сложность вызывает необходи­
мость наличия полной, точной и понятной документации на эти средства, доступной пользователям.
Настоящий стандарт определяет способ достижения данной цели, устанавливая работы (что должно
быть сделано и исполнителя), связанные с качеством документации пользователя программных средств.
      Документация часто рассматривает нечто, разрабатываемое после создания конкретного про­
граммного средства. Однако с точки зрения качества разработки программной документации она
должна рассматриваться как неотъемлемая часть процесса создания данного программного средства.
При надлежащем подходе к данной проблеме требуется достаточно сложная работа по планированию
документирования. Целью настоящего стандарта является стимулирование разработчиков программных
средств к надлежащему использованию процесса документирования. Стандарт также представляет пользо­
вателям метод определения надлежащего применения процесса документирования при создании конк­
ретного программного средства.
      Основной работой по настоящему стандарту яаляется создание комплексного гитана разработки
документации, реализация которого обеспечивает лучшее документирование программного средства.
Для соответствия настоящему стандарту данный план должен включать в себя требования (специфика­
цию) к стилю оформления документов. Настоящий стандарт не определяет состав данных требований
(то есть компоновку конкретного документа или используемый шрифт), но устанавливает их диапазон.
Стандарт также определяет виды информации, представляемой заказчиком разработчику документа­
ции (документатору) для проверяющих и распространяющих документацию.
      Более подробная информация по данному вопросу приведена в библиографии.
       Примечания
       1 Основной стандарт дополнен справочными приложениями, библиографией и тематическим указате­
лем.
     2 Исходный стандарт ИСО/МЭК 15910 разработан на основе австралийского стандарта AS 4258:1994.
     3 Перечень дополнительных публикаций, связанных с тематикой настоящего стандарта, приведен в
библиографии (см. |1| — |21]>.




IV