1.7. Тестирование, верификация и валидация - различия в понятиях

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

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

Рис. 1.7.  Тестирование, верификация и валидация

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

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

Если посмотреть на эти три процесса с точки зрения вопроса, на который они дают ответ, то тестирование отвечает на вопрос "Как это сделано?" или "Соответсвует ли поведение разработанной программы требованиям?", верификация - "Что сделано?" или ""Соответствует ли разработанная система требованиям?", а валидация - "Сделано ли то, что нужно?" или "Соответствует ли разработанная система ожиданиям заказчика?".

32. Проектная документация []

Готовый ответ Милы

• ЕСПД (ГОСТ 19)

(ГОСТ 19.101-77 Единая система программной документации. Виды программ и программных документов)

(ГОСТ 19.004-80 Единая система программной документации. Термины и определения) и пр.

Единая система программной документации (ЕСПД) – комплекс стандартов, содержащих требования к составу, содержанию и оформлению документов, описывающих программу на разных стадиях ее жизненного цикла. Стандарты регламентируют требования к структуре документов и сведениям, которые должны быть изложены в каждом разделе. Стандарты ЕСПД были приняты в конце 70-х годов, с тех пор мало изменялись, поэтому на сегодняшний день могут считаться устаревшими. Но при этом стандарты ЕСПД содержат набор формальных и легко проверяемых требований к составу и оформлению документов, поэтому могут эффективно использоваться с соответствующими поправками на современные требования к программному обеспечению.

• КСАС (ГОСТ 34)

(Документация на автоматизированную систему (АС) по ГОСТ 34.003-90)

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

• ИСО/МЭК

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

• Техническая документация на продукцию по Р 50-605-80-93

Рекомендации содержат термины и определения основных понятий, применяемых в Системе разработки и постановки продукции на производство при создании, производстве и эксплуатации или потреблении продукции.

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

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

В целом для создания любого вида АС перечень НТД должен включать в себя:

• ГОСТ 34.601-90, регламентирующий стадии (и этапы) создания АС - описание процессов в их хронологическом порядке;

• ГОСТ 34.201-89, регламетирующий виды, комплектность и обозначения (наименования) документов, разрабатываемых на стадиях и этапах проведения работ по созданию АС;

• РД 50-34.689-90, регламентирующий требования к содержанию документов на АС;

• ряд ГОСТ 2 (ЕСКД), регламентирующих требования к содержанию и оформлению документов на изделия, входящие в состав АС;

• ГОСТ 2.601-95, регламентирующий требования к эксплуатационной документации на изделия, входящие в состав АС;

• ряд ГОСТ 19 (ЕСПД), регламентирующих требования к содержанию и оформлению документов на программные изделия, входящие в состав АС;

• ряд ГОСТ по качеству технической документации;

• плюс ГОСТ (технические регламенты) предметной области.

• ГОСТ 28806-90 Качество программных средств. Термины и определения

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

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

• ГОСТ 28195-89 Оценка качества программных средств. Общие положения

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

• ГОСТ Р ИСО/МЭК 12119-2000 Информационная технология. Пакеты программ. Требования к качеству и тестирование

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

• ГОСТ Р ИСО/МЭК 15288-2005 Информационная технология. Системная инженерия. Процессы жизненного цикла систем

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

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

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

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

• ГОСТ Р ИСО/МЭК 9294-93 Информационная технология. Руководство по управлению документированием программного обеспечения. Стандарт полностью соответствует международному стандарту ИСО/МЭК ТО 9294:1990 и устанавливает рекомендации по эффективному управлению документированием ПС для руководителей, отвечающих за их создание. Целью стандарта является оказание помощи в определении стратегии документирования ПС; выборе стандартов по документированию; выборе процедур документирования; определении необходимых ресурсов; составлении планов документирования.

• ГОСТ Р ИСО/МЭК 9126-93 Информационная технология. Оценка программной продукции. Характеристики качества и руководства по их применению. Стандарт полностью соответствует международному стандарту ИСО/МЭК 9126:1991. В его контексте под характеристикой качества понимается "набор свойств (атрибутов) программной продукции, по которым ее качество описывается и оценивается". Стандарт определяет шесть комплексных характеристик, которые с минимальным дублированием описывают качество ПС (ПО, программной продукции): функциональные возможности; надежность; практичность; эффективность; сопровождаемость; мобильность. Эти характеристики образуют основу для дальнейшего уточнения и описания качества ПС.

• ГОСТ Р ИСО 9127-94 Системы обработки информации. Документация пользователя и информация на упаковке для потребительских программных пакетов. Стандарт полностью соответствует международному стандарту ИСО 9127:1989. В контексте настоящего стандарта под потребительским программным пакетом (ПП) понимается "программная продукция, спроектированная и продаваемая для выполнения определенных функций; программа и соответствующая ей документация, упакованные для продажи как единое целое". Под документацией пользователя понимается документация, которая обеспечивает конечного пользователя информацией по установке и эксплуатации ПП. Под информацией на упаковке понимают информацию, воспроизводимую на внешней упаковке ПП. Ее целью является предоставление потенциальным покупателям первичных сведений о ПП.

• ГОСТ Р ИСО/МЭК 8631-94 Информационная технология. Программные конструктивы и условные обозначения для их представления. Описывает представление процедурных алгоритмов.

• РД 50-34.698-90 АВТОМАТИЗИРОВАННЫЕ СИСТЕМЫ ТРЕБОВАНИЯ К СОДЕРЖАНИЮ ДОКУМЕНТОВ

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

• 34.601-90 (Стадии создания АС), ГОСТ 34.602—89 (ТЗ на создание АС), ГОСТ 34.603-92 (Виды испытаний АС)

Перечень документов ЕСПД.

• ГОСТ 19.001-77 ЕСПД. Общие положения.

• ГОСТ 19.101-77 ЕСПД. Виды программ и программных документов.

• ГОСТ 19.102-77 ЕСПД. Стадии разработки.

• ГОСТ 19.103-77 ЕСПД. Обозначение программ и программных документов.

• ГОСТ 19.104-78 ЕСПД. Основные надписи.

• ГОСТ 19.105-78 ЕСПД. Общие требования к программным документам.

• ГОСТ 19.106-78 ЕСПД. Требования к программным документам, выполненным печатным способом.

• ГОСТ 19.201-78 ЕСПД. Техническое задание. Требования к содержанию и оформлению.

• ГОСТ 19.202-78 ЕСПД. Спецификация. Требования к содержанию и оформлению.

• ГОСТ 19.301-79 ЕСПД. Порядок и методика испытаний.

• ГОСТ 19.401-78 ЕСПД. Текст программы. Требования к содержанию и оформлению.

• ГОСТ 19.402-78 ЕСПД. Описание программы.

• ГОСТ 19.404-79 ЕСПД. Пояснительная записка. Требования к содержанию и оформлению.

• ГОСТ 19.501-78 ЕСПД. Формуляр. Требования к содержанию и оформлению.

• ГОСТ 19.502-78 ЕСПД. Описание применения. Требования к содержанию и оформлению.

• ГОСТ 19.503-79 ЕСПД. Руководство системного программиста. Требования к содержанию и оформлению.

• ГОСТ 19.504-79 ЕСПД. Руководство программиста.

• ГОСТ 19.505-79 ЕСПД. Руководство оператора.

• ГОСТ 19.506-79 ЕСПД. Описание языка.

• ГОСТ 19.508-79 ЕСПД. Руководство по техническому обслуживанию. Требования к содержанию и оформлению.

• ГОСТ 19.604-78 ЕСПД. Правила внесения изменений в программные документы, выполняемые печатным способом.

• ГОСТ 19.701-90 ЕСПД. Схемы алгоритмов, программ, данных и систем. Условные обозначения и правила выполнения.

• ГОСТ 19.781-90. Обеспечение систем обработки информации программное.

Ответ прошлых лет (Ден)

Прежде чем определятся со стандартами, регулирующими процесс жизненного цикла ПО, дадим определение жизненного цикла. Жизненный цикл программного обеспечения (ПО) — период времени, который начинается с момента принятия решения о необходимости создания программного продукта и заканчивается в момент его полного изъятия из эксплуатации. Этот цикл — процесс построения и развития ПО. Основными стандартами, определяющими состав, содержание и требования к оформлению документации жизненного цикла ПО являются:

• ГОСТ 34.601-90

• ISO/IEC 12207:1995 (российский аналог — ГОСТ Р ИСО/МЭК 12207-99)

Работы по созданию и управлению жизненным циклом ПО регулируются принятой методологией. Методоло́гия — система базисных принципов, методов, методик, способов и средств их реализации в организации и построении научно-практической деятельности людей. Небольшой перечень наиболее популярных в настоящее время методологий – Waterfall (водопадная), XP (экстремальное программирование), RUP ( Унифицированный процесс), SCRUM.

ГОСТ 34.601-90 – Автоматизированные системы. Стадии их создания. Данный стандарт датирован 01.01.1992 г. и распространяется на автоматизированные системы (АС), используемые в различных видах деятельности (исследование, проектирование, управление и т.п.), включая их сочетания, создаваемые в организациях, объединениях и на предприятиях.

Стандарт ГОСТ 34.601-90 предусматривает следующие стадии и этапы создания автоматизированной системы:

1. Формирование требований к АС

   1. Обследование объекта и обоснование необходимости создания АС

   2. Формирование требований пользователя к АС

   3. Оформление отчета о выполнении работ и заявки на разработку АС

2. Разработка концепции АС

   1. Изучение объекта

   2. Проведение необходимых научно-исследовательских работ

   3. Разработка вариантов концепции АС и выбор варианта концепции АС, удовлетворяющего требованиям пользователей

   4. Оформление отчета о проделанной работе

3. Техническое задание

   1. Разработка и утверждение технического задания на создание АС

4. Эскизный проект

   1. Разработка предварительных проектных решений по системе и ее частям

   2. Разработка документации на АС и ее части

5. Технический проект

   1. Разработка проектных решений по системе и ее частям

   2. Разработка документации на АС и ее части

   3. Разработка и оформление документации на поставку комплектующих изделий

   4. Разработка заданий на проектирование в смежных частях проекта

6. Рабочая документация

   1. Разработка рабочей документации на АС и ее части

   2. Разработка и адаптация программ

7. Ввод в действие

   1. Подготовка объекта автоматизации

   2. Подготовка персонала

   3. Комплектация АС поставляемыми изделиями (программными и техническими средствами, программно-техническими комплексами)

   4. Строительно-монтажные работы

   5. Пусконаладочные работы

   6. Проведение предварительных испытаний

   7. Проведение опытной эксплуатации

   8. Проведение приемочных испытаний

8. Сопровождение АС.

   1. Выполнение работ в соответствии с гарантийными обязательствами

   2. Послегарантийное обслуживание

Эскизный, технический проекты и рабочая документация — это последовательное построение все более точных проектных решений. Допускается исключать стадию «Эскизный проект» и отдельные этапы работ на всех стадиях, объединять стадии «Технический проект» и «Рабочая документация» в «Технорабочий проект», параллельно выполнять различные этапы и работы, включать дополнительные.

Стандарт ISO/IEC 12207:1995 «Information Technology — Software Life Cycle Processes» является основным нормативным документом, регламентирующим состав процессов жизненного цикла ПО. Он определяет структуру жизненного цикла, содержащую процессы, действия и задачи, которые должны быть выполнены во время создания ПО. Первая редакция ISO12207 подготовлена в 1995 году объединенным техническим комитетом ISO/IEC JTC1 "Информационные технологии, подкомитет SC7, проектирование программного обеспечения".

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

Очень важные ЗАМЕЧАНИЯ СТАНДАРТА:

1. Процессы, используемые во время ЖЦ ПО, должны быть совместимы с процессами, используемыми во время ЖЦ АС. (Отсюда понятна целесообразность совместного использования стандартов на АС и на ПО.)

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

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

ГОСТ Р ИСО/МЭК 12207-99 Информационная технология. Процессы жизненного цикла программных средств. Настоящий стандарт применяется при приобретении систем, программных продуктов и оказании соответствующих услуг; а также при поставке, разработке, эксплуатации и сопровождении программных продуктов и программных компонентов программно-аппаратных средств как в самой организации, так и вне ее. Стандарт содержит также те аспекты описания системы, которые необходимы для обеспечения понимания сути программных продуктов и услуг. Стандарт не распространяется на готовые программные продукты, если они не входят в поставляемый продукт. Стандарт предназначен для: заказчиков систем, программных продуктов и услуг; поставщиков; разработчиков; операторов; персонала сопровождения; администраторов проектов; администраторов, отвечающих за качество, и пользователей программных продуктов.

33. Проектная документация []

Готовый ответ Вани

ГОСТ 34.602-89 распространяется на автоматизированные системы (АС) для автоматизации различных видов деятельности (управление, проектирование, исследование и т. п.), включая их сочетания, и устанавливает состав, содержание, правила оформления документа «Техническое задание на создание (развитие или модернизацию) системы» (далее - ТЗ на АС). ТЗ на АС является основным документом, определяющим требования и порядок создания автоматизированной системы, в соответствии с которым проводится разработка АС и ее приемка при вводе в действие. ТЗ на АС разрабатывают на систему в целом, предназначенную для работы самостоятельно или в составе другой системы. ТЗ на АС разрабатывают на основании исходных данных в том числе содержащихся в итоговой документации стадии «Исследование и обоснование создания АС», установленной ГОСТ 24.601.

ТЗ на АС содержит следующие разделы, которые могут быть разделены на подразделы:

1) общие сведения;

2) назначение и цели создания (развития) системы;

3) характеристика объектов автоматизации;

4) требования к системе;

5) состав и содержание работ по созданию системы;

6) порядок контроля и приемки системы;

7) требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие;

8) требования к документированию;

9) источники разработки.

Раздел «Общие сведения» содержит общие сведения о создаваемой системе:

1) полное наименование системы и ее условное обозначение;

2) шифр темы или шифр (номер) договора;

3) наименование предприятий (объединений) разработчика и заказчика (пользователя) системы и их реквизиты;

4) перечень документов, на основании которых создается система, кем и когда утверждены эти документы;

5) плановые сроки начала, и окончания работы по созданию системы;

6) сведения об источниках и порядке финансирования работ;

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

Раздел «Назначение и цели создания (развития) системы» состоит из подразделов:

1) назначение системы;

2) цели создания системы.

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

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

Раздел «Характеристики объекта автоматизации»:

1) краткие сведения об объекте автоматизации или ссылки на документы, содержащие такую информацию;

2) сведения об условиях эксплуатации объекта автоматизации и характеристиках окружающей среды.

Раздел «Требования к системе» состоит из следующих подразделов:

1) требования к системе в целом;

2) требования к функциям (задачам), выполняемым системой;

3) требования к видам обеспечения.

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

Раздел «Состав и содержание работ по созданию (развитию) системы» должен содержать перечень стадий и этапов работ по созданию системы в соответствии с ГОСТ 24.601, сроки их выполнения, перечень организаций-исполнителей работ, ссылки на документы, подтверждающие согласие этих организаций на участие в создании системы, или запись, определяющую ответственного (заказчик или разработчик) за проведение этих работ.

Раздел «Порядок контроля и приемки системы»: виды, состав, объем и методы испытаний системы и ее составных частей, общие требования к приемке работ по стадиям, порядок согласования и утверждения приемочной документации, статус приемочной комиссии (государственная, межведомственная, ведомственная).

Раздел «Требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие» содержит перечень основных мероприятий и их исполнителей, которые следует выполнить при подготовке объекта автоматизации к вводу АС в действие.

Раздел «Требования к документированию»:

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

2) требования по документированию комплектующих элементов межотраслевого применения в соответствии с требованиями ЕСКД и ЕСПД;

3) при отсутствии государственных стандартов, определяющих требования к документированию элементов системы, дополнительно включают требования к составу и содержанию таких документов.

Раздел «Источники разработки»: документы и информационные материалы (технико-экономическое обоснование, отчеты о законченных научно-исследовательских работах, информационные материалы на отечественные, зарубежные системы-аналоги и др.), на основании которых разрабатывалось ТЗ и которые должны быть использованы при создании системы.

Приложения (включают при наличии утвержденных методик):

1) расчет ожидаемой эффективности системы;

2) оценку научно-технического уровня системы.

Ответ прошлых лет (Ден)

ГОСТ 34.602-89. Настоящий стандарт распространяется на автоматизированные системы (АС) для автоматизации различных видов деятельности (управление, проектирование, исследование и т. п.), включая их сочетания, и устанавливает состав, содержание, правила оформления документа «Техническое задание на создание (развитие или модернизацию) системы» (далее - ТЗ на АС). ТЗ на АС является основным документом, определяющим требования и порядок создания автоматизированной системы, в соответствии с которым проводится разработка АС и ее приемка при вводе в действие. ТЗ на АС разрабатывают на систему в целом, предназначенную для работы самостоятельно или в составе другой системы. ТЗ на АС разрабатывают на основании исходных данных в том числе содержащихся в итоговой документации стадии «Исследование и обоснование создания АС», установленной ГОСТ 24.601.

ТЗ на АС содержит следующие разделы, которые могут быть разделены на подразделы:

1) общие сведения;

2) назначение и цели создания (развития) системы;

3) характеристика объектов автоматизации;

4) требования к системе;

5) состав и содержание работ по созданию системы;

6) порядок контроля и приемки системы;

7) требования к составу и содержанию работ по подготовке объекта автоматизации к вводу системы в действие;

8) требования к документированию;

9) источники разработки.

Также в ТЗ на АС могут включаться приложения.

В разделе «Общие сведения» указывают:

• полное наименование системы и ее условное обозначение;

• шифр темы или номер договора;

• наименование предприятий разработчика и заказчика системы и их реквизиты;

• перечень документов, на основании которых создается система, кем и когда утверждены эти документы;

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

• сведения об источниках и порядке финансирования работ;

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

Раздел «Назначение и цели создания (развития) системы» состоит из подразделов:

• назначение системы;

• цели создания системы.

В подразделе «Назначение системы» указывают вид автоматизируемой деятельности (управление, проектирование и т. п.) и перечень объектов автоматизации (объектов), на которых предполагается ее использовать. Для АСУ дополнительно указывают перечень автоматизируемых органов (пунктов) управления и управляемых объектов.

В подразделе «Цели создания системы» приводят наименования и требуемые значения технических, технологических, производственно-экономических или других показателей объекта автоматизации, которые должны быть достигнуты в результате создания АС, и указывают критерии оценки достижения целей создания системы.

В разделе «Характеристики объекта автоматизации» приводят:

• краткие сведения об объекте автоматизации или ссылки на документы, содержащие такую информацию;

• сведения об условиях эксплуатации объекта автоматизации и характеристиках окружающей среды.

Раздел «Требования к системе» состоит из следующих подразделов:

• требования к системе в целом;

• требования к функциям (задачам), выполняемым системой;

• требования к видам обеспечения.

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

В подразделе «Требования к системе в целом» указываются

1. требования к структуре и функционированию системы;

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

3. показатели назначения;

4. требования к надежности;

5. требования безопасности;

6. требования к эргономике и технической эстетике;

7. требования к транспортабельности для подвижных АС;

8. требования к эксплуатации, техническому обслуживанию, ремонту и хранению компонентов системы;

9. требования к защите информации от несанкционированного доступа;

10. требования по сохранности информации при авариях;

11. требования к защите от влияния внешних воздействий;

12. требования к патентной чистоте;

13. требования по стандартизации и унификации;

14. дополнительные требования.

В подразделе «Требование к функциям (задачам)», выполняемым системой, приводят:

• по каждой подсистеме перечень функций, задач или их комплексов (в том числе обеспечивающих взаимодействие частей системы), подлежащих автоматизации; при создании системы в две или более очереди - перечень функциональных подсистем, отдельных функций или задач, вводимых в действие в 1-й и последующих очередях;

• временной регламент реализации каждой функции, задачи (или комплекса задач);

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

• перечень и критерии отказов для каждой функции, по которой задаются требования по надежности.

В подразделе «Требования к видам обеспечения» в зависимости от вида системы приводят требования к математическому, информационному, лингвистическому, программному, техническому, метрологическому, организационному, методическому и другие видам обеспечения системы.

Раздел «Состав и содержание работ по созданию (развитию) системы» должен содержать перечень стадий и этапов работ по созданию системы в соответствии с ГОСТ 24.601, сроки их выполнения, перечень организаций - исполнителей работ, ссылки на документы, подтверждающие согласие этих организаций на участие в создании системы, или запись, определяющую ответственного (заказчик или разработчик) за проведение этих работ.

В данном разделе также приводят:

• перечень документов, по ГОСТ 34.201-89 (виды, комплектность и обозначение документов при создании АСУ), предъявляемых по окончании соответствующих стадий и этапов работ;

• вид и порядок проведения экспертизы технической документации (стадия, этап, объем проверяемой документации, организация-эксперт);

• программу работ, направленных на обеспечение требуемого уровня надежности разрабатываемой системы (при необходимости);

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

В разделе «Порядок контроля и приемки системы» указывают:

• виды, состав, объем и методы испытаний системы и ее составных частей (виды испытаний в соответствии с действующими нормами, распространяющимися на разрабатываемую систему);

• общие требования к приемке работ по стадиям (перечень участвующих предприятий и организаций, место и сроки проведения), порядок согласования и утверждения приемочной документации;

• статус приемочной комиссии (государственная, межведомственная, ведомственная).

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

В перечень основных мероприятий включают:

• приведение поступающей в систему информации (в соответствии с требованиями к информационному и лингвистическому обеспечению) к виду, пригодному для обработки с помощью ЭВМ;

• изменения, которые необходимо осуществить в объекте автоматизации;

• создание условий функционирования объекта автоматизации, при которых гарантируется соответствие создаваемой системы требованиям, содержащимся в ТЗ;

• создание необходимых для функционирования системы подразделений и служб;

• сроки и порядок комплектования штатов и обучения персонала.

В разделе «Требования к документированию» приводят:

• согласованный разработчиком и Заказчиком системы перечень подлежащих разработке комплектов и видов документов, соответствующих требованиям ГОСТ 34.201-89 и НТД отрасли заказчика; перечень документов, выпускаемых на машинных носителях; требования к микрофильмированию документации;

• 2) требования по документированию комплектующих элементов межотраслевого применения в соответствии с требованиями ЕСКД и ЕСПД;

• 3) при отсутствии государственных стандартов, определяющих требования к документированию элементов системы, дополнительно включают требования к составу и содержанию таких документов.

В разделе «Источники разработки» должны быть перечислены документы и информационные материалы (технико-экономическое обоснование, отчеты о законченных научно-исследовательских работах, информационные материалы на отечественные, зарубежные системы-аналоги и др.), на основании которых разрабатывалось ТЗ и которые должны быть использованы при создании системы.

В состав ТЗ на АС при наличии утвержденных методик включают приложения, содержащие:

• расчет ожидаемой эффективности системы;

• оценку научно-технического уровня системы.

Приложения включают в состав ТЗ на АС по согласованию между разработчиком и заказчиком системы.

34. Проектная документация []

Ответ прошлых лет (Ден)

ГОСТ 34.602-89. Настоящий стандарт распространяется на автоматизированные системы (АС) для автоматизации различных видов деятельности (управление, проектирование, исследование и т. п.), включая их сочетания, и устанавливает состав, содержание, правила оформления документа «Техническое задание на создание (развитие или модернизацию) системы» (далее - ТЗ на АС). ТЗ на АС является основным документом, определяющим требования и порядок создания автоматизированной системы, в соответствии с которым проводится разработка АС и ее приемка при вводе в действие. ТЗ на АС разрабатывают на систему в целом, предназначенную для работы самостоятельно или в составе другой системы. ТЗ на АС разрабатывают на основании исходных данных в том числе содержащихся в итоговой документации стадии «Исследование и обоснование создания АС», установленной ГОСТ 24.601.

Раздел, в котором указан типовой состав и содержательная характеристика общих требований к разрабатываемой системе называется «Требования к системе» и состоит из следующих подразделов:

• требования к системе в целом;

• требования к функциям (задачам), выполняемым системой;

• требования к видам обеспечения.

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

В подразделе «Требования к системе в целом» указывают:

1. требования к структуре и функционированию системы;

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

3. показатели назначения;

4. требования к надежности;

5. требования безопасности;

6. требования к эргономике и технической эстетике;

7. требования к транспортабельности для подвижных АС;

8. требования к эксплуатации, техническому обслуживанию, ремонту и хранению компонентов системы;

9. требования к защите информации от несанкционированного доступа;

10. требования по сохранности информации при авариях;

11. требования к защите от влияния внешних воздействий;

12. требования к патентной чистоте;

13. требования по стандартизации и унификации;

14. дополнительные требования.

1. В требованиях к структуре и функционированию системы приводят:

• перечень подсистем, их назначение и основные характеристики, требования к числу уровней иерархии и степени централизации системы;

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

• требования к характеристикам взаимосвязей создаваемой системы со смежными системами, требования к ее совместимости, в том числе указания о способах обмена информацией;

• требования к режимам функционирования системы;

• требования по диагностированию системы;

• перспективы развития, модернизации системы.

Комментарии Маятина: Уже на уровне проектирования указать, какие будут подсистемы (модули выделяются по задачам), как эти подсистемы связаны между собой, оперативность передачи информации (время возможной критической ошибки и т.д.)

2. В требованиях к численности и квалификации персонала на АС приводят:

• требования к численности персонала (пользователей) АС;

• требования к квалификации персонала, порядку его подготовки и контроля знаний и навыков;

• требуемый режим работы персонала АС.

Комментарии Маятина: Это (навыки, квалификация, численность) указывается обязательно, чтобы обезопасить себя и программиста

3. В требованиях к показателям назначения АС приводят значения параметров, характеризующие степень соответствия системы ее назначению:

• степень приспособляемости системы к изменению процессов и методов управления, к отклонениям параметров объекта управления (если условия меняются, например, изменение сменности, расширение производства);

• допустимые пределы модернизации и развития системы (модернизация конфигурирования системы и т.д.);

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

4. В требования к надежности включают:

• состав и количественные значения показателей надежности для системы в целом или ее подсистем;

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

• требования к надежности технических средств и программного обеспечения;

• требования к методам оценки и контроля показателей надежности на разных стадиях создания системы в соответствии с действующими нормативно-техническими документами.

Комментарии Маятина: Надёжность – предосмотреть, какие могут быть штатные ситуации, нештатные (не являются нормой, но предусмотрены), неучтённые ситуации (форс-мажор)

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

Комментарии Маятина: Безопасность – насколько безопасна для пользователя

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

Комментарии Маятина: Эргономика- доступ к функциям быстрый, сенсорный экран нормальный и т.д.

Техническая эстетика – внешний вид

7. Для подвижных АС в требования к транспортабельности включают конструктивные требования, обеспечивающие транспортабельность технических средств системы, а также требования к транспортным средствам.

Комментарии Маятина: может быть, а может и не быть; зависит от того, есть ли движущиеся объекты

8. В требования к эксплуатации, техническому обслуживанию, ремонту и хранению включают:

• условия и регламент (режим) эксплуатации, которые должны обеспечивать использование технических средств (ТС) системы с заданными техническими показателями, в том числе виды и периодичность обслуживания ТС системы или допустимость работы без обслуживания;

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

• требования по количеству, квалификации обслуживающего персонала и режимам его работы;

• требования к составу, размещению и условиям хранения комплекта запасных изделий и приборов;

• требования к регламенту обслуживания.

Комментарии Маятина: площади, которые нужны для внедрения, влажность, температура воздуха,наличие лифта, возможность внести оборудование (габариты); можно указать, что обслуживание производится только разработчиками (чтобы заказчик обращался к вам и только)

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

10. В требованиях по сохранности информации приводят перечень событий: аварий, отказов технических средств (в том числе - потеря питания) и т. п., при которых должна быть обеспечена сохранность информации в системе.

11. В требованиях к средствам защиты от внешних воздействий приводят:

• требования к радиоэлектронной защите средств АС;

• требования по стойкости, устойчивости и прочности к внешним воздействиям (среде применения).

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

Комментарии Маятина: относительно патентных законодательств система будет чиста (только в РФ или за рубежом?); патентная чистота разработчика (открытые или закрытые коды)

13. В требования к стандартизации и унификации включают: показатели, устанавливающие требуемую степень использования стандартных, унифицированных методов реализации функций (задач) системы, поставляемых программных средств, типовых математических методов и моделей, типовых проектных решений, унифицированных форм управленческих документов, установленных ГОСТ 6.10.1, общесоюзных классификаторов технико-экономической информации и классификаторов других категорий в соответствии с областью их применения, требования к использованию типовых автоматизированных рабочих мест, компонентов и комплексов.

Комментарии Маятина: аппаратные средства – в каких сетях электропитания работает, разъёмы разеток; ПО – зависимость от платформы, универсальность алгоритмов и т.д.

14. В дополнительные требования включают:

• требования к оснащению системы устройствами для обучения персонала и документацией на них;

• требования к сервисной аппаратуре, стендам для проверки элементов системы;

• требования к системе, связанные с особыми условиями эксплуатации;

• специальные требования по усмотрению разработчика или заказчика системы.

В подразделе «Требование к функциям (задачам)», выполняемым системой, приводят:

• по каждой подсистеме перечень функций, задач или их комплексов (в том числе обеспечивающих взаимодействие частей системы), подлежащих автоматизации; при создании системы в две или более очереди - перечень функциональных подсистем, отдельных функций или задач, вводимых в действие в 1-й и последующих очередях;

• временной регламент реализации каждой функции, задачи (или комплекса задач);

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

• перечень и критерии отказов для каждой функции, по которой задаются требования по надежности.

В подразделе «Требования к видам обеспечения» в зависимости от вида системы приводят требования:

• к математическому обеспеспечению – (может быть, может не быть) – ограничение к использованию алгоритмов

• информационному обеспечению;

• лингвистическому обеспечению:

  • требования для локализации – на каких языках интерфейс, руководство, документы на систему;

  • требования к уровню перевода – уровень сертификации перевода;

  • требовнаия к применению конкретных языков программирования и их диалектов (если дальнейшая разработка будет проводиться силами компании)

• программному обеспечению – внешнее ПО, если в системе используются отдельные модули других программ;

• техническому – требования, касающиеся готовых аппаратных комплексов,

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

• методическому и другие видам обеспечения системы.

35. Проектная документация []

Ответ прошлых лет (Ден)

ГОСТ 34.602-89. Настоящий стандарт распространяется на автоматизированные системы (АС) для автоматизации различных видов деятельности (управление, проектирование, исследование и т. п.), включая их сочетания, и устанавливает состав, содержание, правила оформления документа «Техническое задание на создание (развитие или модернизацию) системы» (далее - ТЗ на АС). ТЗ на АС является основным документом, определяющим требования и порядок создания автоматизированной системы, в соответствии с которым проводится разработка АС и ее приемка при вводе в действие. ТЗ на АС разрабатывают на систему в целом, предназначенную для работы самостоятельно или в составе другой системы. ТЗ на АС разрабатывают на основании исходных данных в том числе содержащихся в итоговой документации стадии «Исследование и обоснование создания АС», установленной ГОСТ 24.601.

Раздел, в котором указан типовой состав и содержательная характеристика требований к видам обеспечения автоматизированной системы называется «Требования к системе» и состоит из следующих подразделов:

• требования к системе в целом;

• требования к функциям (задачам), выполняемым системой;

• требования к видам обеспечения.

В подразделе «Требования к видам обеспечения» в зависимости от вида системы приводят требования к математическому, информационному, лингвистическому, программному, техническому, метрологическому, организационному, методическому и другие видам обеспечения системы.

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

Для информационного обеспечения системы приводят требования:

• к составу, структуре и способам организации данных в системе;

• к информационному обмену между компонентами системы;

• к информационной совместимости со смежными системами;

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

• по применению систем управления базами данных;

• к структуре процесса сбора, обработки, передачи данных в системе и представлению данных;

• к защите данных от разрушений при авариях и сбоях в электропитании системы;

• к контролю, хранению, обновлению и восстановлению данных;

• к процедуре придания юридической силы документам, продуцируемым техническими средствами АС (в соответствии с ГОСТ 6.10.4).

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

Для программного обеспечения системы приводят перечень покупных программных средств, а также требования:

• к независимости программных средств от используемых СВТ и операционной среды;

• к качеству программных средств, а также к способам его обеспечения и контроля;

• по необходимости согласования вновь разрабатываемых программных средств с фондом алгоритмов и программ.

Для технического обеспечения системы приводят требования:

• к видам технических средств, в том числе к видам комплексов технических средств, программно-технических комплексов и других комплектующих изделий, допустимых к использованию в системе;

• к функциональным, конструктивным и эксплуатационным характеристикам средств технического обеспечения системы.

В требованиях к метрологическому обеспечению приводят:

• предварительный перечень измерительных каналов;

• требования к точности измерений параметров и (или) к метрологическим характеристикам измерительных каналов;

• требования к метрологической совместимости технических средств системы;

• перечень управляющих и вычислительных каналов системы, для которых необходимо оценивать точностные характеристики;

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

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

Для организационного обеспечения приводят требования:

• к структуре и функциям подразделений, участвующих в функционировании системы или обеспечивающих эксплуатацию;

• к организации функционирования системы и порядку взаимодействия персонала АС и персонала объекта автоматизации;

• к защите от ошибочных действий персонала системы.

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

36. Проектная документация []

Готовый ответ Вани

Раздел «Состав и содержание работ по созданию (развитию) системы» должен содержать перечень стадий и этапов работ по созданию системы в соответствии с ГОСТ 24.601, сроки их выполнения, перечень организаций-исполнителей работ, ссылки на документы, подтверждающие согласие этих организаций на участие в создании системы, или запись, определяющую ответственного (заказчик или разработчик) за проведение этих работ.

В данном разделе также приводят:

1) перечень документов, по ГОСТ 34.201, предъявляемых по окончании соответствующих стадий и этапов работ;

2) вид и порядок проведения экспертизы технической документации (стадия, этап, объем проверяемой документации, организация-эксперт);

3) программу работ, направленных на обеспечение требуемого уровня надежности разрабатываемое системы (при необходимости);

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

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

В перечень основных мероприятий включают:

1) приведение поступающей в систему информации (в соответствии с требованиями к информационному и лингвистическому обеспечению) к виду, пригодному для обработки с помощью ЭВМ;

2) изменения, которые необходимо осуществить в объекте автоматизации;

3) создание условий функционирования объекта автоматизации, при которых гарантируется соответствие создаваемой системы требованиям, содержащимся в ТЗ;

4) создание необходимых для функционирования системы подразделений и служб;

5) сроки и порядок комплектования штатов и обучения персонала.

В разделе «Требования к документированию» приводят:

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

2) требования по документированию комплектующих элементов межотраслевого применения в соответствии с требованиями ЕСКД и ЕСПД;

3) при отсутствии государственных стандартов, определяющих требования к документированию элементов системы, дополнительно включают требования к составу и содержанию таких документов.

Ответ прошлых лет (Ден)

ГОСТ 34.602-89. Настоящий стандарт распространяется на автоматизированные системы (АС) для автоматизации различных видов деятельности (управление, проектирование, исследование и т. п.), включая их сочетания, и устанавливает состав, содержание, правила оформления документа «Техническое задание на создание (развитие или модернизацию) системы» (далее - ТЗ на АС). ТЗ на АС является основным документом, определяющим требования и порядок создания автоматизированной системы, в соответствии с которым проводится разработка АС и ее приемка при вводе в действие. ТЗ на АС разрабатывают на систему в целом, предназначенную для работы самостоятельно или в составе другой системы. ТЗ на АС разрабатывают на основании исходных данных в том числе содержащихся в итоговой документации стадии «Исследование и обоснование создания АС», установленной ГОСТ 24.601.

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

В перечень основных мероприятий включают:

• приведение поступающей в систему информации (в соответствии с требованиями к информационному и лингвистическому обеспечению) к виду, пригодному для обработки с помощью ЭВМ;

• изменения, которые необходимо осуществить в объекте автоматизации;

• создание условий функционирования объекта автоматизации, при которых гарантируется соответствие создаваемой системы требованиям, содержащимся в ТЗ;

• создание необходимых для функционирования системы подразделений и служб;

• сроки и порядок комплектования штатов и обучения персонала.

Например, для АСУ приводят:

• изменения применяемых методов управления;

• создание условий для работы компонентов АСУ, при которых гарантируется соответствие системы требованиям, содержащимся в ТЗ.

В требованиях к документированию приводят:

• согласованный разработчиком и Заказчиком системы перечень подлежащих разработке комплектов и видов документов, соответствующих требованиям ГОСТ 34.201-89 и НТД отрасли заказчика;

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

• требования к микрофильмированию документации;

• требования по документированию комплектующих элементов межотраслевого применения в соответствии с требованиями ЕСКД и ЕСПД;

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

37. Проектная документация []

Ответ прошлых лет (Ден)

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

Отчет о НИР — научно-технический документ, который содержит систематизированные данные о научно-исследовательской работе, описывает состояние научно-технической проблемы, процесс и/или результаты научного исследования. По результатам выполнения НИР составляется заключительный отчет о работе в целом. Кроме того, по отдельным этапам НИР могут быть составлены промежуточные отчеты, что отражается в Техническом задании на НИР и в календарном плане выполнения НИР. Ответственность за достоверность данных, содержащихся в отчете, и за соответствие его требованиям настоящего стандарта несет организация-исполнитель.

Отчет о НИР подлежит обязательному нормоконтролю в организации-исполнителе. При проведении нормоконтроля рекомендуется руководствоваться ГОСТ 2.111.

Основными структурными элементами отчета о НИР являются:

1. титульный лист;

2. список исполнителей;

3. реферат;

4. содержание;

5. нормативные ссылки;

6. определения;

7. обозначения и сокращения;

8. введение;

9. основная часть;

10. заключение;

11. список использованных источников;

12. приложения.

Требования к содержанию структурных элементов отчета:

1. Титульный лист

Титульный лист является первой страницей отчета о НИР и служит, источником информации, необходимой для обработки и поиска документа. На титульном листе приводят следующие сведения:

• наименование вышестоящей организации;

• наименование организации-исполнителя НИР;

• индекс Универсальной десятичной классификации (УДК);

• коды Высших классификационных группировок Общероссийского классификатора промышленной и сельскохозяйственной продукции для НИР (ВКГОКП), предшествующих постановке продукции на производство;

• номера, идентифицирующие отчет;

• грифы согласования и утверждения;

• наименование работы;

• наименование отчета;

• вид отчета (заключительный, промежуточный);

• номер (шифр) работы;

• должности, ученые степени, ученые звания, фамилии и инициалы руководителей организации-исполнителя НИР, руководителей НИР;

• место и дату составления отчета.

Если отчет о НИР состоит из двух и более частей, то каждая часть должна иметь свой титульный лист, соответствующий титульному листу первой части и содержащий сведения, относящиеся к данной части.

2. Список исполнителей

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

3. Реферат

Реферат должен содержать:

• сведения об объеме отчета, количестве иллюстраций, таблиц, приложений, количестве частей отчета, количестве использованных источников;

• перечень ключевых слов;

• текст реферата.

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

Текст реферата должен отражать:

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

• цель работы;

• метод или методологию проведения работы;

• результаты работы;

• основные конструктивные, технологические и технико-эксплуатационные характеристики;

• степень внедрения;

• рекомендации по внедрению или итоги внедрения результатов НИР;

• область применения;

• экономическую эффективность или значимость работы;

• прогнозные предположения о развитии объекта исследования.

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

4. Содержание

Содержание включает введение, наименование всех разделов, подразделов, пунктов (если они имеют наименование), заключение, список использованных источников и наименование приложений с указанием номеров страниц, с которых начинаются эти элементы отчета о НИР. При составлении отчета, состоящего из двух и более частей, в каждой из них должно быть свое содержание. При этом в первой части помещают содержание всего отчета с указанием номеров частей, в последующих — только содержание соответствующей части. Допускается в первой части вместо содержания последующих частей указывать только их наименования. В отчете о НИР объемом не более 10 страниц содержание допускается не составлять.

5. Нормативные ссылки

Структурный элемент «Нормативные ссылки» содержит перечень стандартов, на которые в тексте стандарта дана ссылка. Перечень ссылочных стандартов начинают со слов: «В настоящем отчете о НИР использованы ссылки на следующие стандарты». В перечень включают обозначения стандартов и их наименования в порядке возрастания регистрационных номеров обозначений.

6 Определения

Структурный элемент «Определения» содержит определения, необходимые для уточнения или установления терминов, используемых в НИР. Перечень определений начинают со слов: «В настоящем отчете о НИР применяют следующие термины с соответствующими определениями».

7 Обозначения и сокращения

Структурный элемент «Обозначения и сокращения» содержит перечень обозначений и сокращений, применяемых в данном отчете о НИР. Запись обозначений и сокращений проводят в порядке приведения их в тексте отчета с необходимой расшифровкой и пояснениями. Допускается определения, обозначения и сокращения приводить в одном структурном элементе «Определения, обозначения и сокращения».

8. Введение

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

9 Основная часть

В основной части отчета приводят данные, отражающие сущность, методику и основные результаты выполненной НИР. Основная часть должна содержать:

1. выбор направления исследований, включающий обоснование направления исследования, методы решения задач и их сравнительную оценку, описание выбранной общей методики проведения НИР;

2. процесс теоретических и (или) экспериментальных исследований, включая определение характера и содержания теоретических исследований, методы исследований, методы расчета, обоснование необходимости проведения экспериментальных работ, принципы действия разработанных объектов, их характеристики;

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

10 Заключение

Заключение должно содержать:

• краткие выводы по результатам выполнений НИР или отдельных ее этапов;

• оценку полноты решений поставленных задач;

• разработку рекомендаций и исходных данных по конкретному использованию результатов НИР;

• оценку технико-экономической эффективности внедрения; — оценку научно-технического уровня выполненной НИР в сравнении с лучшими достижениями в данной области.

11 Список использованных источников

Список должен содержать сведения об источниках, использованных при составлении отчета. Сведения об источниках приводятся в соответствии с требованиями ГОСТ 7.1.

12 Приложения

В приложения рекомендуется включать материалы, связанные с выполненной НИР, которые по каким-либо причинам не могут быть включены в основную часть.

В приложения могут быть включены:

• промежуточные математические доказательства, формулы и расчеты; — таблицы вспомогательных цифровых данных;

• протоколы испытаний;

• описание аппаратуры и приборов, применяемых при проведении экспериментов, измерений и испытаний;

• заключение метрологической экспертизы;

• инструкции, методики, разработанные в процессе выполнения НИР;

• иллюстрации вспомогательного характера;

• копии технического задания на НИР, программы работ, договора или другого исходного документа для выполнения НИР;

• протокол рассмотрения выполненной НИР на научно-техническом совете;

• акты внедрения результатов НИР и др.

В приложения к отчету о НИР, предшествующему постановке продукции на производство, должен быть включен проект технического задания на разработку (модернизацию) продукции или документ (заявка, протокол, контракт и др.), содержащий обоснованные технико-экономические требования к продукции. Также в приложения к отчету о НИР, в составе которой предусмотрено проведение патентных исследований, должен быть включен отчет о патентных исследованиях, оформленный по ГОСТ 15.011 , библиографический список публикаций и патентных документов, полученных в результате выполнения НИР, — по ГОСТ 7.1.

Правила оформления отчета

Общие требования

Изложение текста и оформление отчета выполняют в соответствии с требованиями настоящего стандарта, ГОСТ 2.105 и ГОСТ 6.38. Страницы текста отчета о НИР и включенные в отчет иллюстрации и таблицы должны соответствовать формату А4 по ГОСТ 9327. Отчет о НИР должен быть выполнен любым печатным способом на пишущей машинке или с использованием компьютера и принтера на одной стороне листа белой бумаги формата А4 через полтора интервала. Цвет шрифта должен быть черным, высота букв, цифр и других знаков — не менее 1,8 мм (кегль не менее 12).

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

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

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

Фамилии, названия учреждений, организаций, фирм, название изделий и другие имена собственные в отчете приводят на языке оригинала. Допускается транслитерировать имена собственные и приводить названия организаций в переводе на язык отчета с добавлением (при первом упоминании) оригинального названия. Сокращение русских слов и словосочетаний в отчете — по ГОСТ 7.12.

Построение отчета

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

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

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

Нумерация страниц отчета

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

Нумерация разделов, подразделов, пунктов, подпунктов отчета

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

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

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

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

Иллюстрации

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

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

Фотоснимки размером меньше формата А4 должны быть наклеены на стандартные листы белой бумаги. Иллюстрации, за исключением иллюстрации приложений, следует нумеровать арабскими цифрами сквозной нумерацией. Если рисунок один, то он обозначается «Рисунок 1». Слово «рисунок» и его наименование располагают посередине строки.

Допускается нумеровать иллюстрации в пределах раздела. В этом случае номер иллюстрации состоит из номера раздела и порядкового номера иллюстрации, разделенных точкой. Например, Рисунок 1.1.

Иллюстрации, при необходимости, могут иметь наименование и пояснительные данные. Слово «Рисунок» и наименование помещают после пояснительных данных и располагают следующим образом: Рисунок 1 — Детали прибора.

Иллюстрации каждого приложения обозначают отдельной нумерацией арабскими цифрами с добавлением перед цифрой обозначения приложения. При ссылках на иллюстрации следует писать «... в соответствии с рисунком 2» при сквозной нумерации и «... в соответствии с рисунком 1.2» при нумерации в пределах раздела.

Таблицы

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

Таблицу следует располагать в отчете непосредственно после текста, в котором она упоминается впервые, или на следующей странице. На все таблицы должны быть ссылки в отчете. При ссылке следует писать слово «таблица» с указанием ее номера. Таблицу с большим количеством строк допускается переносить на другой лист. При переносе части таблицы на другой лист слово «Таблица» и номер ее указывают один раз справа над первой частью таблицы, над другими частями пишут слово «Продолжение» и указывают номер таблицы, например: «Продолжение таблицы 1». При переносе таблицы на другой лист заголовок помещают только над ее первой частью.

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

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

Таблицы каждого приложения обозначают отдельной нумерацией арабскими цифрами с добавлением перед цифрой обозначения приложения. Если в документе одна таблица, то она должна быть обозначена «Таблица 1» или «Таблица В. 1», если она приведена в приложении В.

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

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

Примечания

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

Формулы и уравнения

Уравнения и формулы следует выделять из текста в отдельную строку. Выше и ниже каждой формулы или уравнения должно быть оставлено не менее одной свободной строки. Если уравнение не умещается в одну строку, то оно должно быть перенесено после знака равенства (=) или после знаков плюс (+), минус (-), умножения (х), деления (:), или других математических знаков, причем знак в начале следующей строки повторяют. При переносе формулы на знаке, символизирующем операцию умножения, применяют знак «X».

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

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

Допускается нумерация формул в пределах раздела. В этом случае номер формулы состоит из номера раздела и порядкового номера формулы, разделенных точкой, например (3.1).

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

Ссылки

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

Титульный лист

Титульный лист содержит реквизиты:

• наименование вышестоящей организации или другого структурного образования, в систему которого входит организация-исполнитель, наименование организации (в том числе и сокращенное);

• индекс УДК, код ВКГ Общероссийского классификатора продукции (ОКП) (для отчетов о НИР, предшествующих разработке и модернизации продукции) и номер государственной регистрации НИР, проставляемые организацией-исполнителем, а также надпись «Инв. №» — эти данные размещаются одно под другим;

• специальные отметки (при наличии в отчете численных данных о свойствах веществ и материалов в этой части проставляется аббревиатура ГСССД — государственная служба стандартных справочных данных);

• гриф согласования, гриф утверждения.

Гриф утверждения состоит из слова «УТВЕРЖДАЮ», должности с указанием наименования организации, ученой степени, ученого звания лица, утвердившего отчет, личной подписи, ее расшифровки и даты утверждения отчета. Здесь же проставляется печать организации, утвердившей отчет.

Гриф согласования состоит из слова «СОГЛАСОВАНО», должности с указанием наименования организации, ученой степени, ученого звания лица, согласовавшего отчет, его личной подписи, ее расшифровки, даты согласования, печати согласующей организации.

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

В реквизитах «гриф согласования» и «гриф утверждения» составные части, состоящие из нескольких строк, печатают через 1 межстрочный интервал, а сами составные части отделяют друг от друга 1,5 межстрочным интервалом.

Подписи и даты подписания должны быть выполнены только черными чернилами или тушью.

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

— вид документа — строчными буквами с первой прописной, наименование НИР — прописными буквами, наименование отчета — строчными буквами в круглых скобках, вид отчета (промежуточный или заключительный) — строчными буквами с первой прописной (если наименование НИР совпадает с наименованием отчета, то его печатают прописными буквами);

— шифр государственной научно-технической программы, шифр работы, присвоенный организацией-

исполнителем;

— должности, ученые степени, ученые звания руководителей организации-исполнителя НИР, руководителей НИР (если печатается в несколько строк, то печатать через 1 межстрочный интервал), затем оставляют свободное поле для личных подписей и помещают инициалы и фамилии лиц, подписавших отчет, ниже личных подписей проставляют даты подписания (если на титульном листе не размещаются все необходимые подписи, то допускается переносить их на следующую страницу);

— город и год выпуска отчета.

Список исполнителей

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

Перечень обозначений

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

Список использованных источников

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

Приложения

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

Приложения обозначают заглавными буквами русского алфавита, начиная с А, за исключением букв Ё, З, И, О, Ч, Ь, Ы, Ъ. После слова «Приложение» следует буква, обозначающая его последовательность. Допускается обозначение приложений буквами латинского алфавита, за исключением букв I и O. В случае полного использования букв русского и латинского алфавитов допускается обозначать приложения арабскими цифрами. Если в документе одно приложение, оно обозначается «Приложение А».

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

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

38. Проектная документация []

Готовый ответ Тони

Стандарт ГОСТ Р ИСО/МЭК ТО 9294-93 представляет собой руководство по документированию программного обеспечения для тех руководителей, которые отвечают за производство программного обеспечения или программной продукции. Руководство предназначено для помощи руководителям в обеспечении эффективного проведения документирования в их организациях. Данный стандарт направлен на определение стратегий, стандартов, процедур, ресурсов и планов, которыми должны заниматься сами руководители для того, чтобы эффективно управлять документированием программного обеспечения.

Установление стратегии документирования

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

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

Стратегия должна поддерживать основные элементы эффективного документирования:

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

2) документирование должно быть управляемым.

3) документация должна соответствовать ее читательской аудитории.

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

5) должны быть определены и использованы стандарты по документированию.

6) должны быть определены средства поддержки.