Пользовательская документация программных средств

Обеспечение мобильности.

Мобильность ПС определяется такими примитивами качества ПС как независимость от устройств, автономность, структурированность и модульность

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

Таким образом, для обеспечения мобильности ПС нужно решить две задачи:

· выделение по возможности наибольшей части программ ПС, обладающей свойствами независимости от устройств и автономности (другими словами, независимой от аппаратно-операционной платформы);

· обеспечение сопровождаемости для остальных частей программ ПС.

Документация, создаваемая в процессе разработки программных средств.

Эту документацию можно разбить на две группы:

• Документы управления разработкой ПС.

• Документы, входящие в состав ПС.

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

• Планы, оценки, расписания. для прогнозирования и управления процессами разработки и сопровождения.

• Отчеты об использовании ресурсов в процессе разработки.

• Стандарты. предписывают разработчикам, каким принципам, правилам, соглашениям они должны следовать в процессе разработки ПС.

• Рабочие документы. Это основные технические документы, обеспечивающие связь между разработчиками. Они содержат фиксацию идей и проблем, возникающих в процессе разработки, описание используемых стратегий и подходов, а также рабочие (временные) версии документов, которые должны войти в ПС.

• Заметки и переписка. Эти документы фиксируют различные детали взаимодействия между менеджерами и разработчиками.

Документы, входящие в состав ПС, описывают программы ПС как с точки зрения их применения пользователями, так и с точки зрения их разработчиков и сопроводителей (в соответствии с назначением ПС). Здесь следует отметить, что эти документы будут использоваться не только на стадии эксплуатации ПС (в ее фазах применения и сопровождения), но и на стадии разработки для управления процессом разработки (вместе с рабочими документами) - во всяком случае они должны быть проверены (протестированы) на соответствие программам ПС. Эти документы образуют два комплекта с разным назначением:

• Пользовательская документация ПС

• Документация по сопровождению ПС

Пользовательская документация программных средств

Пользовательская документация ПС объясняет пользователям, как они должны действовать, чтобы применить данное ПС. две категории пользователей ПС: ординарных пользователей ПС и администраторов ПС. Ординарный пользователь ПС использует ПС для решения своих задач (в своей предметной области). Администратор ПС управляет использованием ПС ординарными пользователями и осуществляет сопровождение ПС. состав пользователь­ской документации для достаточно больших ПС:

• Общее функциональное описание ПС. Дает краткую характеристику функциональных
возможностей ПС. Предназначено для пользователей, которые должны решить, насколько
необходимо им данное ПС.

• Руководство по инсталляции ПС. Предназначено для системных администраторов. Он должен детально предписывать, как устанавливать системы в конкретной среде..

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

• Справочник по применению ПС.

Руководство по управлению ПС. Предназначено для системных администраторов.

63. Документация по сопровождению программных средств. описывает ПС с точки зрения ее разработки.

Документация по сопровождению ПС можно разбить на две группы:

-документация, определяющая строение программ и структур данных ПС и технологию их разработки;

-документацию, помогающую вносить изменения в ПС.

Документация первой группы содержит итоговые документы каждого технологического этапа разработки ПС. Она включает следующие документы:

• Внешнее описание ПС

• Описание архитектуры ПC, включая внешнюю специфика­цию каждой ее программы.

• Для каждой программы ПС - описание ее модульной структуры, включая внешнюю специфика­цию каждого включенного в нее модуля.

• Для каждого модуля - его спецификация и описание его строения

• Тексты модулей на выбранном языке программирования

Документы установления достоверности ПС

•Руководство по сопровождению ПС которое описывает известные
проблемы вместе с ПС, какие части системы являются аппаратно- и программно-
зависимыми, и как развитие ПС принято в расчет в его строении Общая проблема сопровождения ПС - обеспечить, чтобы все его представления шли в ногу (оставались согласованными), когда ПС изменяется. Чтобы этому помочь, связи и зависимости между документами и их частями должны быть зафиксированы в базе данных управления конфигурацией.