Лекция №8 Тема Виды документации

7.1.Требования к содержанию и оформлению формуляра

7.2.Требования к содержанию и оформлению описания применения

Формуляр (код вида документа - 30) - содержит основные характеристики программы, комплектность и сведения об эксплуатации программы.  Описание применения (код вида документа - 31) - содержит сведения о назначении программы, области применения, применяемых методах, классе решаемых задач, ограничениях для применения, минимальной конфигурации технических средств. 

Текст основной части документа должен состоять из следующих разделов: 

назначения программы,  условий применения,  входных и выходных данных.  В зависимости от особенностей программы допускается вводить дополнительные разделы или объединять отдельные разделы.  В разделе  Назначение программы указывают назначение, возможности, характеристики программы, ограничения, накладываемые на области ее применения.  Раздел Условия применения содержит сведения об условиях, необходимых для выполнения программы: требования к техническим средствам, другим программам, к входной и выходной информации, требования и условия организационного, технического и технологического характера и т.п.  В разделе Описание задачи должны быть указаны определения задачи и методы ее решения.  В разделе Входные и выходные данные приводят сведения о структуре и форматах входных и выходных данных.  Лекция №9 Тема Виды документации

9.1.Руководство системного программиста

9.2.Руководство программиста

9.3.Руководство оператора

9.1.Аннотация и содержание обязательны.  Руководство системного программиста должно содержать следующие разделы:  Общие сведения о программе - назначение и функции программы и сведения о технических и программных средствах, обеспечивающих выполнение данной программы. 

Структура программы - сведения о структуре программы, ее составных частях, о связях между составными частями и о связях с другими программами. 

Настройка программы - описание действий по настройке программы на условия конкретного применения (настройка на состав технических средств, выбор функций и др.). 

Проверка программы - описание способов проверки, позволяющих дать общее заключение о работоспособности программы (контрольные примеры, методы прогона, результаты). 

Дополнительные возможности - описание дополнительных разделов функциональных возможностей программы и способов их выбора. 

Сообщения системному программисту - тексты сообщений, выдаваемых в ходе выполнения программы, описания их содержания и действий, которые необходимо выполнять по этим сообщениям. 

В зависимости от особенностей документа допускается объединять отдельные разделы и вводить новые. В обоснованных случаях допускается раздел "Дополнительные возможности" не приводить, а в наименованиях разделов опускать слово "программа" или заменять его на "наименование программы".  В приложении к руководству системного программиста могут быть приведены дополнительные материалы (примеры, иллюстрации, таблицы, графики и т.п.).  9.2.Руководство программиста

Аннотация и содержание обязательны.  Руководство программиста должно содержать следующие разделы:  - Назначение и условия применения - назначение и функции, условия, необходимые для выполнения (объем оперативной памяти, требования к составу и параметрам периферийных устройств, требования к программному обеспечению)

- Характеристики программы - описание основных характеристик и особенностей программы (временные характеристики, режим работы, средства контроля правильности выполнения и cамовосстанавливаемости программы и т.п.).

- Обращение к программе - описание процедур вызова программы (способы передачи управления и параметров данных и др.). 

- Входные и выходные данные - описание организации входной и выходной информации и, при необходимости, ее кодирования. 

- Сообщения - тексты сообщений, выдаваемых программисту или оператору в ходе выполнения программы, описание их содержания и действий, которые необходимо предпринять по этим сообщениям. 

зависимости от особенностей документа допускается объединять отдельные разделы и вводить новые.  В приложении к руководству программиста могут быть приведены дополнительные материалы (примеры, иллюстрации, таблицы, графики и т.п.).  9.3.Руководство оператора

Аннотация и содержание обязательны.  Руководство оператора должно содержать следующие разделы:  - Назначение программы - сведения о назначении и информация, достаточная для понимания функций программы и ее эксплуатации. 

- Условия выполнения программы - условия, необходимые для выполнения программы (минимальный и (или) максимальный состав аппаратурных и программных средств и т.п.). 

- Выполнение программы - последовательность действий оператора, обеспечивающих загрузку, запуск и завершение программы, приведено описание функций, форматов и возможных вариантов команд, с помощью которых оператор осуществляет загрузку и управляет выполнением программы, а также ответы программы на эти команды. 

- Сообщения оператору - тексты сообщений, выдаваемых в ходе выполнения программы, описание их содержания и соответствующих действий оператора (действия оператора в случае сбоя, возможности повторного запуска программы и т.п.). 

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