ГОСТ 19.106-78 ЕСПД. «Требования к программным документам, выполненным печатным способом» устанавливает правила выполнения программных документов для вычислительных машин, комплексов и систем независимо от их назначения и области применения и предусмотренных стандартами ЕСПД.
В соответствии с данным стандартом следует оформлять, вообще говоря, все, что приходится писать разработчику, в том числе, техническую документацию, статьи и т.д. Поэтому целесообразно рассмотреть его более подробно.
Программные документы, разработанные в дипломных (курсовых) проектах (работах) различных проблемных областей, также должны оформляться в соответствии с требованиями стандартов Единой системы программной документации (ЕСПД).
Общие требования.Вписывать в программные документы, выполненные машинописным, машинным и рукописным способами, отдельные слова, формулы, условные знаки (от руки чертежным шрифтом), буквы латинского и греческого алфавитов, а так же выполнять схемы и рисунки необходимо черными чернилами или тушью.
Опечатки и графические неточности, обнаруженные в процессе выполнения, допускается исправлять подчисткой некачественно выполненной части текста (чертежа) и нанесением на том же листе исправленного текста (графики) машинописью или черной тушью в зависимости от способа выполнения документа.
Повреждение листов документов, помарки и следы не полностью удаленного текста (графики) не допускаются.
Программные документы оформляют на листах формата А4. Кроме того:
- допустимо оформление на листах формата А3;
- при машинном способе выполнения документа допускаются отклонения размеров листов, соответствующих форматам А4 и А3, определяемые возможностями применяемых технических средств; на листах форматов А4 и А3, предусматриваемых выходными характеристиками устройств вывода данных, при изготовлении документа машинным способом;
- при изготовлении документа типографским способом возможно использование листов типографических форматов.
Расположение материалов программного документа осуществляется в следующей последовательности:
- титульная часть:
-лист утверждения (не входит в общее количество листов документа);
-титульный лист (первый лист документа);
- информационная часть:
-аннотация;
-лист содержания;
- основная часть:
-текст документа (с рисунками, таблицами и т.п.);
-перечень терминов и их определений;
-перечень сокращений;
-приложения;
-предметный указатель;
-перечень ссылочных документов;
Построение документа.При необходимости допускается делить документ на части. Деление на части осуществляется на уровне не ниже раздела. Каждую часть комплектуют отдельно, при этом в конце содержания первой части следует перечислить названия остальных частей.
Допускается включение в документ частей текста программы, оформляемых в соответствии с правилами языка, на котором написан текст программы.
Аннотацию размещают на отдельной странице (страницах), снабжают заголовком АННОТАЦИЯ, нумеруют и включают в содержание документа.
Содержание документа размещают на отдельной странице (страницах), снабжают заголовком СОДЕРЖАНИЕ и включают в общее количество страниц документа. В содержании документа дается перечисление наименований разделов и подразделов и номеров страниц.
Текст каждого документа, при необходимости, разбивается на пункты, а пункты – на подпункты, независимо от того, разделен документ на части, разделы и подразделы или нет.
Заголовки разделов пишут прописными буквами и размещают симметрично относительно правой и левой границ текста. Заголовки подразделов записывают с абзаца строчными буквами (кроме первой прописной). Переносы слов в заголовках не допускаются. Точку в конце заголовка не ставят. Каждый раздел рекомендуется начинать с нового листа.
Разделы, подразделы, пункты и подпункты следует нумеровать арабскими цифрами с точкой. Разделы должны иметь порядковый номер (1, 2 и т.д.)
Текст документа. Текст документа должен быть кратким, четким, исключающим возможность неверного толкования. Термины и определения должны быть едиными и соответствовать установленным стандартам, а при их отсутствии – общепринятым в научно-технической литературе, и приводиться в перечне терминов.
Необходимые пояснения к тексту документа могут оформляться сносками. Сноска обозначается цифрой со скобкой, вынесенной на уровень линии верхнего обреза шрифта.
Если сноска относится к отдельному слову, знак сноски помещается непосредственно возле этого слова, если же к предложению в целом, то в конце предложения. Текст сноски располагают в конце страницы и отделяют от основного текста линией длиной 3 см, проведенной в левой части страницы.
Иллюстрации. Иллюстрации могут быть расположены в тексте документа и (или) в приложениях. Иллюстрации, если их в данном документе более одной, нумеруют арабскими цифрами в пределах всего документа.
В приложениях иллюстрации нумеруются в пределах каждого приложения в порядке, установленном для основного текста документа. Ссылки на иллюстрации дают по типу: рис.12 или (рис.12). Иллюстрации могут иметь тематический заголовок и подрисуночный текст, поясняющий содержание иллюстрации.
Формулы. Формулы в документе, если их более одной, нумеруются арабскими цифрами, номер ставят с правой стороны страницы, в скобках на уровне формулы. В пределах всего документа или его частей, в случае деления документа на части, формулы имеют сквозную нумерацию.
Ссылки в тексте на порядковый номер формулы дают в скобках, например: в формуле (3). При делении документа на части номер части ставится перед порядковым номером формулы и отделяется от последней точкой, например: в формуле (1.4).
Значение символов, входящих в формулу, должны быть приведены непосредственно под формулой. Значение каждого символа печатают с новой строки в той последовательности, в какой они приведены в формуле. Первая строка расшифровки должна начинаться со слова где, без двоеточия после него.
Ссылки. В программных документах допускаются ссылки на стандарты и другие документы. Ссылаться следует на документ в целом или на его разделы (с указанием обозначения и наименования документа, номера и наименования раздела или приложения).
Допускается указывать только обозначение документа и (или) разделов без указания их наименований. Ссылки на отдельные подразделы, пункты и иллюстрации другого документа не допускаются. Допускаются ссылки внутри документа на пункты, иллюстрации и отдельные подразделы.
Примечания. В примечаниях к тексту и таблицам указывают только справочные и пояснительные данные. Одно примечание не нумеруется. Тогда после слова Примечание ставят точку. Несколько примечаний следует нумеровать по порядку арабскими цифрами с точкой. И в этом случае после слова Примечание ставят двоеточие. Текст примечаний допускается печатать только через один интервал.
Сокращения. Сокращения слов в тексте и надписях под иллюстрациями не допускаются, за исключением:
- сокращений, установленных в ГОСТ 2.316-68, и общепринятых в технической литературе;
- сокращений, применяемых для обозначения программ, их частей и режимов работы, в языках управления заданиями, в средствах настройки программы и т.п., обозначаемых буквами латинского алфавита.
Приложения. Иллюстрированный материал, таблицы или текст вспомогательного характера допускается оформлять в виде приложений. Приложения оформляют как продолжение данного документа на последующих страницах или выпускают в виде отдельного документа.
Каждое приложение должно начинаться с новой страницы с указанием в правом верхнем углу слова Приложение и иметь тематический заголовок. При наличии в документе более одного приложения все приложения нумеруют арабскими цифрами (без знака ‘№’), например:
Приложение 1, Приложение 2 и т.д.
При выпуске приложения отдельным документом, на титульном листе под наименованием документа следует указывать слово Приложение, а при наличии нескольких приложений указывают также его порядковый номер.
