Программная документация.

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

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

На основе внешней спецификации модулей осуществляется разработка логической структуры этих модулей. Логическая структура модуля прорабатывается на стадии технического проекта программы.

Внешняя спецификация модуля должна включать:

1. Имя модуля, используемое при обращении к нему.

2. Описание функции, здесь приводится назначение модуля, но оно не должно содержать сведений о логической структуре и о контекстах, в которых используется модуль.

3. Список параметров: число и порядок задания параметров.

4. Входные параметры: подробное описание и их атрибуты (структура, размер, единица измерения, допустимый диапазон назначений, типы и т.д.).

5. Выходные параметры (аналогично п.4).

6. Внешние эффекты.

Например: печать сообщений, чтение запроса с монитора, вывод сообщений об ошибке.

Внешние эффекты модуля включают все внешние эффекты подчинённых ему модулей.

Средства проектирования прикладных программ.

1. Графическое построение схем алгоритмов и программ.

ГОСТ 19.002 - 80

19.003 - 80

Применяется ограниченно это средство программирования, вследствие недостатков:

1. высокая трудоёмкость вычерчивания схем;

2. отсутствие графических средств для отображения структур данных;

3. не отражает особенностей конструкций конкретных языков программирования;

4. потеря наглядности при большом количестве блочных символов.

2. Разработка схем алгоритмов и программ с использованием конкретного языка программирования.

Недостатки:

1. современные языки программирования не обладают наглядными средствами для описания алгоритмов;

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

3. Использование специальных языков проектирования программ, псевдокодов.

Псевдокод – это частично формализованная запись для наглядного текстового представления схем алгоритмов и программ, разрабатываемая в соответствии с общими принципами структурного программирования. Псевдокод используется в следующих целях:

1. для фиксации с нужным уровнем детализации алгоритма в процессе его разработки;

2. для формулировки заданий на кодирование программы на языке программирования;

3. для описания логики программы.

Достоинство псевдокода:

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

Основные элементы языка псевдокода:

1. Алфавит: строчные, прописные буквы латиницы и кириллицы, специальные символы, цифры

2. Идентификаторы: имена.

3. Ключевые слова: используются для обозначения операторов и конструкций языка. При написании их желательно подчеркивать.

4. Константы: символьные и другие.

5. Комментарии: могут располагаться в любом месте текста, отделяются от него знаками «-».