Технологические аспекты разработки ПО АСОИУ. - 25 стр.

UptoLike

Рубрика:

Ссылка на номер формулы в тексте даётся в круглых скобках. Напри-

мер: «расчёт значений x производится по формуле (1)».

3.3. Оформление текстов программных модулей

Тексты программ должны оформляться в соответствии с «хорошим сти-

лем» программирования, т.е. должны быть легко читаемы и хорошо доку-

ментированы. В текстах должны быть комментарии:

– после заголовка программы или подпрограммы (общая информация:

назначение, входные данные, результаты, метод решения; данные о про-

граммисте, дата написания, версия);

– при объявлении данных (назначение переменных);

– в начале и конце определённой функционально законченной части

программы;

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

Однако комментарии не должны затенять структуру текста, они должны

быть ясными и краткими. Наименования программ и подпрограмм должны

отражать их назначение. Логическая структура программы должна быть от-

ражена в её тексте с помощью:

– пустых строк между текстами подпрограмм и отдельных её функцио-

нально законченных частей;

– сдвигами текста в строке при написании:

заголовков вложенных циклов;

тела цикла после его заголовка;

альтернатив разветвлений процесса обработки данных.

3.4. Оформление приложений

Каждое приложение должно начинаться с новой страницы с указанием в

правом верхнем углу страницы слова «ПРИЛОЖЕНИЕ», выполненного про-

писными буквами, и иметь тематический заголовок. При наличии более од-

ного приложения все они нумеруются арабскими цифрами: ПРИЛОЖЕНИЕ

1, ПРИЛОЖЕНИЕ 2 и т.д.