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

Цели и задачи документирования во многом определяются видом разработки. Разработки, согласно Р 50-605-80-93,бывают разные, к примеру:

• инициативная разработка;
• разработка в интересах заказчика;
• разработка в интересах пользователя (потребителя).

Инициативная разработка

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

Классическим примером инициативной разработки можно считать работы по созданию и сопровождению АС портала sportbox.ru (телеканала «Спорт»). Работа ведется силами заказчика в интересах самого же заказчика. Приемки работы не ожидается - не принимать же ее у самого себя? АС портала развивается, меняются дизайн, техническая и программная платформы, администраторы обеспечивают работу программистов и тестировщиков, редакторы отвечают за информационное наполнение ресурса.

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

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

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

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

Разработка в интересах заказчика

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

Цели и задачи документирования разработки, проводимой в интересах заказчика:

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

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

Разработка в интересах пользователя (потребителя)

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

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

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

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

Заказать услуги, установить контакты со специалистами компании можно по электронной почте admin собака tdocs точка su, по ICQ UIN 481-726-610 или с помощью формы «Контакты». Вопросы некоммерческого характера могут быть заданы в Форуме проектировщиков и разработчиков технической документации.