Рекомендации по выбору документов

Рекомендации по выбору документов

Если непонятно, какие именно документы вам нужны, рекомендует ознакомиться с данным материалом.

Предупреждение

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

Список рекомендаций

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

☞ Техническое задание (свободный/пользовательский формат) Technical specification for development

☒ Основной документ для конечного пользователя (инструкция), в котором описано использование ПО по назначению

☞ Руководство пользователя (свободный/пользовательский формат) User guide

☒ Основной документ для конечного пользователя (инструкция), в котором описана установка и настройка ПО

☞ Руководство администратора (свободный/пользовательский формат) Administration guide

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

☞ Руководство программиста (свободный/пользовательский формат) Programmer's guide

☒ Минимальный комплект документации для разработки ПО

☞ Техническое задание (свободный/пользовательский формат) Technical specification for development
☞ Пояснительная записка (свободный/пользовательский формат) Explanatory Note
☞ Программа и методика испытаний (свободный/пользовательский формат) Program and methods of testing
☞ Описание программного обеспечения (свободный/пользовательский формат) Program description

☒ Минимальный комплект документации для релиза ПО (вариант 1)

☞ Руководство администратора (свободный/пользовательский формат) Administration guide
☞ Руководство пользователя (свободный/пользовательский формат) User guide
☞ Руководство программиста (свободный/пользовательский формат) Programmer's guide

☒ Минимальный комплект документации для релиза ПО (вариант 2)

☞ Быстрый старт (–) Quick start
☞ Замечания по версии (–) Release notes
☞ Краткое описание (–) Readme
☞ Справочник разработчика (–) Programming guide
☞ Справочное руководство (–) Reference guide
☞ Часто задаваемые вопросы (–) FAQ

☒ Комплект документации по ГОСТ 19 для сдачи госзаказчику

☞ Ведомость эксплуатационных документов (ГОСТ 19.507-79) List of operational documentation
☞ Пояснительная записка (ГОСТ 19.404-79) Exlanatory Note
☞ Программа и методика испытаний (ГОСТ 19.203-78) Program and methods of testing
☞ Руководство оператора (ГОСТ 19.505-79) Operator's guide
☞ Руководство программиста (ГОСТ 19.504-79) Programmer's guide
☞ Руководство системного программиста (ГОСТ 19.503-79) System programmer's guide
☞ Спецификация (ГОСТ 19.202-78) Specifications
☞ Формуляр (ГОСТ 19.501-78) Technical and operation data card

☒ Комплект документации по ГОСТ 34 для сдачи госзаказчику

☞ Ведомость технического проекта (РД 50-34.698-90) List of project documents
☞ Ведомость эксплуатационных документов (РД 50-34.698-90) List of operational documentation
☞ Ведомость эскизного проекта (РД 50-34.698-90) List of preliminary design documents
☞ Описание автоматизируемых функций (РД 50-34.698-90) Automated functions description
☞ Описание алгоритма (проектной процедуры) (РД 50-34.698-90) Algorithm description
☞ Описание информационного обеспечения системы (РД 50-34.698-90) Data management description
☞ Описание комплекса технических средств (РД 50-34.698-90) Hardware description
☞ Описание программного обеспечения (РД 50-34.698-90) Software description
☞ Пояснительная записка к техническому проекту (РД 50-34.698-90) Project explanatory note
☞ Пояснительная записка к эскизному проекту (РД 50-34.698-90) Explanatory Note to the preliminary design
☞ Программа и методика испытаний (РД 50-34.698-90) Program and methods of testing
☞ Руководство администратора (РД 50-34.698-90) Administration guide
☞ Руководство пользователя (РД 50-34.698-90) User guide

☒ Комплект документации для маркетинга и продаж

☞ Белые страницы (–) White papers
☞ Бизнес-план (–) Business plan
☞ Договор (–) Contract (agreement)
☞ История успеха (–) Success story
☞ Коммерческое предложение (–) Commercial offer
☞ Корпоративная информация (–) Corporate papers
☞ Маркетинговые материалы (–) Marketing materials
☞ Материалы для обучения (–) Training materials
☞ Презентация (–) Presentation

Заключение

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

Обратите также внимание, что комплект документации для одного продукта заказывать всегда намного выгоднее, чем разрабатывать документы по отдельности: это связано со спецификой алгоритма оценки трудоемкости разработки документации. Например, у нас при заказе комплекта экономия может достигать 35% от итоговой суммы заказа.