Пояснительная записка

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

Назначение пояснительной записки

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

Состав типовой пояснительной записки

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

– Введение. В этом разделе приводится полное наименование системы и тема разработки, а также список документов, послуживших основанием для работ по проекту.

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

– Технические характеристики. Этот раздел обычно разбивают на подразделы, в которых описывают: постановку задачи на создание программы; используемый математический аппарат; алгоритм работы ПО; структуру входных и выходных данных; состав технических и программных средств. Также необходимо приводить расчеты и результаты анализа для обоснования выбора именно тех решений, о которых говорится в документе.

– Ожидаемые технико-экономические показатели. Раздел предполагает экономическое обоснование разработки с учетом ее технических показателей.

– Источники, использованные при разработке. Раздел представляет собой список документов, статей и публикаций, на которые были приведены ссылки в тексте.

Стандарты для пояснительной записки

Состав разделов определяется ГОСТом ГОСТ 19.404, однако, стандарт позволяет эти разделы при необходимости объединять, а также добавлять новые. В случае использования ГОСТ серии 34 следует разрабатывать документ в соответствии с РД 50-34.698. Тем не менее, документ должен оставаться в рамках требований общих стандартов, таких, например, как ГОСТ 19.105.

Заключение

Как же с наименьшими затратами создать документ на программу, максимально полезный для вашего проекта, который:

– с одной стороны, внятно и доходчиво представляет все нужные (а порой и нудные) сведения, включая сложные технические подробности;

– с другой стороны, отвечает многочисленным требованиям государственных стандартов как к содержанию, так и к оформлению?

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

– разработка технического задания;
– разработка программы и методики испытаний;
– этапы разработки документации.