8.13. Примечания

В примечаниях к тексту и таблицам указывают только справочные и пояснительные данные. Одно примечание не нумеруется. После слова "Примечание" ставят точку. Несколько примечаний следует нумеровать по порядку арабскими цифрами с точкой. После слова "Примечания" ставят двоеточие.

8.14. Приложения

Иллюстративный материал, таблицы или текст вспомогательного характера допускается оформлять в виде приложений. Приложения оформляют как продолжение данного документа на последующих страницах или выпускают в виде отдельного документа. Каждое приложение должно начинаться с новой страницы с указанием в правом верхнем углу слова "ПРИЛОЖЕНИЕ" прописными буквами и иметь тематический заголовок, который записывают симметрично тексту прописными буквами. При наличии в документе более одного приложения все приложения нумеруют арабскими цифрами (без знака N), например, ПРИЛОЖЕНИЕ 1, ПРИЛОЖЕНИЕ 2 и т.д. Нумерация страниц документа и приложений, входящих в состав документа, должна быть сквозная, на приложения даются ссылки в основном тексте документа и все приложения, иллюстрации и таблицы в приложениях нумеруют в пределах каждого приложения.

При выпуске приложения отдельным документом на титульном листе под видом документа следует указывать слово "ПРИЛОЖЕНИЕ", а при наличии нескольких приложений указывают их порядковые номера. При необходимости в таком приложении может быть помещено "Содержание". Допускается объединять несколько приложений в отдельную часть программного документа, а также содержание каждого приложения разбивать на разделы, подразделы, пункты, нумеруемые отдельно по каждому приложению.

9. Техническое задание. Требования к содержанию и оформлению (гост 19.201-78)

9.1. Общие положения

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

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

Техническое задание является документом, регулирующим и указующим отношение заказчика и разработчика ПС. Ввиду того, что разработка ПС требует определенного времени, в силу объективных и субъективных причин требования к ПС у заказчика изменяются. Удовлетворение возросших потребностей заказчиков может повлечь за собой изменение структур данных готовой части программы, т.е., иногда, значительное изменение сроков разработки. Наличие вовремя оформленного ТЗ дает возможность разработчику обосновать новые капиталовложения, людские ресурсы и изменить время разработки.

Техническое задание оформляют в соответствии с ГОСТ 19.106-78, как правило, без заполнения полей листа. Номера листов проставляют в верхней части листа над текстом. Лист утверждения и титульный лист оформляют в соответствии с ГОСТ 19.104-78. В случае внесения изменений или дополнений в ТЗ на последующих стадиях разработки программы или программного изделия выпускают дополнение к нему. Исполнителю следует следить за своевременностью и обоснованностью внесения изменений.

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

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

– введение;

– основание для разработки;

– назначение разработки;

– требования к программе или программному изделию;

– требования к программной документации;

– технико-экономические показатели;

– стадии и этапы разработки;

– порядок контроля и приемки;

– в техническое задание допускается включатъ приложения.

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