Технология разработки программного обеспечения. Зубкова Т.М. - 30 стр.

       − инструкция по применению ПС предназначена для ординарных
пользователей. Содержит необходимую информацию по применению ПС, ор-
ганизованную в форме удобной для ее изучения;
       − справочник по применению ПС предназначен для ординарных поль-
зователей. Содержит необходимую информацию по применению ПС, органи-
зованную в форме удобной для избирательного поиска отдельных деталей;
       − руководство по управлению ПС предназначено для администрато-
ров ПС. Оно должно описывать сообщения, генерируемые, когда ПС взаимо-
действует с другими системами, и как должен реагировать администратор на
эти сообщения. Кроме того, если ПС использует системную аппаратуру, этот
документ может объяснять, как сопровождать эту аппаратуру.
        Разработка пользовательской документации начинается сразу после
 создания внешнего описания. Качество этой документации может сущест-
 венно определять успех ПС. Она должна быть достаточно проста и удобна
 для пользователя (в противном случае, это ПС вообще не стоило создавать).
 Поэтому, хотя черновые варианты (наброски) пользовательских документов
 создаются основными разработчиками ПС, к созданию их окончательных
 вариантов часто привлекаются профессиональные технические писатели.
        Документация по сопровождению ПС (system documentation) описы-
 вает ПС с точки зрения ее разработки. Эта документация необходима, если
 ПС предполагает изучение того, как оно устроено (сконструировано), и мо-
 дернизацию его программ. Сопровождение − это продолжающаяся разра-
 ботка. Поэтому в случае необходимости модернизации ПС к этой работе
 привлекается специальная команда разработчиков-сопроводителей. Этой
 команде придется иметь дело с такой же документацией, которая определяла
 деятельность команды первоначальных (основных) разработчиков ПС, − с
 той лишь разницей, что эта документация для команды разработчиков-
 сопроводителей будет, как правило, чужой (она создавалась другой коман-
 дой). Чтобы понять строение и процесс разработки модернизируемого ПС,
 команда разработчиков-сопроводителей должна изучить эту документацию,
 а затем внести в нее необходимые изменения, повторяя в значительной сте-
 пени технологические процессы, с помощью которых создавалось первона-
 чальное ПС.
        Документацию по сопровождению ПС можно разбить на две группы:
       − документация, определяющая строение программ и структур дан-
 ных ПС и технологию их разработки;
       − документация, помогающая вносить изменения в ПС.
        Документация первой группы содержит итоговые документы каждо-
 го технологического этапа разработки ПС. Она включает следующие доку-
 менты:
        − внешнее описание ПС (Requirements document);
        − описание архитектуры ПС, включая внешнюю спецификацию каж-
 дой ее программы (подсистемы);


30