Проектирование информационных систем (на примере методов структурного системного анализа): учебное пособие

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

---

96 
2.3. 
Документирование проекта 
Назначение документации 
Документация входит в состав проекта по созданию, внедрению, сопро-
вождению, модернизации и ликвидации ИС на протяжении полного жизненно-
го цикла этой ИС. Документация необходима: 
•
для обеспечения эффективных и экономичных процедур разработки, со-
провождения и использования программных средств и всей ИС;
•
для организации обмена информацией между управляющим персоналом, 
разработчиками, администратором, пользователями ИС, а также другими, 
не предусмотренными проектом лицами и группами (инспектирующими 
структурами и т.п.) на всех стадиях жизненного цикла (ЖЦ) ИС. 
Документация выполняет следующие функции: 
•
дает описание возможностей системы, то есть позволяет пользователю 
определить соответствие программного продукта требованиям, предъяв-
ляемым к ИС в целом; 
•
обеспечивает фиксацию принятых и реализованных проектных решений, 
давая возможность для дальнейшей модификации и совершенствования 
программного обеспечения ИС; 
•
предоставляет технические материалы для анализа информационной си-
стемы на этапах её приобретения и разработки; 
•
предоставляет информацию о процедурах эксплуатации и технического 
обслуживания ИС; 
•
регламентирует средства и процедуры защиты информации, регулирует 
права и обязанности различных групп пользователей ИС, условия функ-
ционирования ИС, включая вопросы ее модернизации, масштабирования, 
переносимости и ликвидации. 

---

97 
Требования к документации 
К документации предъявляют следующие требования: 
1.
документы должны быть ясными, краткими, точными и полными; 
2.
для повышения эффективности работы с документами должны использо-
ваться стандарты, регламентирующие форму, содержание и, иногда, 
стиль документов; 
3.
документация должна создаваться параллельно с разработкой ПО; 
4.
обязанности по документированию системы лежат на ее разработчике, 
создающем, модернизирующем и привлекающем в проект ИС те или 
иные программные средства. Особенно важна внешняя документация; 
5.
документация должна высокий уровень абстракции при возможности 
четкого и однозначного толкования и достаточности информации об опи-
сываемых объектах; 
6.
перед составлением документации необходимо иметь ответ на следую-
щие вопросы: 
•
что и зачем должно быть документировано; 
•
для кого предназначен тот или иной документ; 
•
возможные способы решения тех или иных задач, стоящих перед поль-
зователем; 
•
какие ошибки может допустить пользователь, и что нужно сделать для 
их устранения; 
•
как и в каких условиях будет использоваться документ; 
•
сколько выделено средств, и каковы сроки разработки документа; 
•
кто будет оценивать документ и как он соотносится к отраслевым или 
ведомственным требованиям на сертификацию разработки; 
•
как будет обновляться и поддерживаться документация и каковы ме-
ханизмы и сроки внесения изменений и пересмотра документа; кто от-
ветственен за реализацию этих действий, а также за хранение, неиз-

---

98 
менность и контроль за исполнением. 
Ответы на эти вопросы должны быть получены на ранних стадиях разра-
ботки ИС (на стадии разработки технико-экономического обоснования к ТЗ) и 
входить в состав разрабатываемой в рамках проекта документации. 
Для повышения эффективности разработки программных изделий (ПИ), а 
также повышения их качества необходима стандартизация и унификация доку-
ментов, описывающих как процедуры работ, так и результаты выполнения ра-
бот по созданию программного продукта. С этой целью было разработано не-
сколько десятков отечественных государственных стандартов, из которых 
больше половины были стандартами в рамках Совета экономической взаимо-
помощи (СЭВ) бывшего содружества стран социалистического лагеря (СССР и 
др.), остальные – международными (ISO). 
Состав программных документов по фазам ЖЦ ИС