Калайда В.Т., Романенко В.В. Технология разработки программного обеспечения (2007), страница 36

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

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

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

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

Утвержденный план подкрепляется индивидуальнымипланами.В фазе конструирования группа разработки передаетвнешние спецификации на рассмотрение другим группам. Группа выпуска документации убеждается в том, что внешние спецификации имеют завершенный вид, и начинает готовить рукописи справочных материалов. Если в документацию включенотехническое описание, то работа начинается именно с этого документа, т.к. он должен быть готов в то же самое время, когдагруппа поддержки выпустит рекламные материалы.Если для программного продукта предусмотрен выпусксправочного материала в режиме on-line, группа выпуска документации совместно с группой разработки подготавливаетвнешнюю спецификацию на изделие, в которой описываютсяформаты и содержание всех сообщений, выдаваемых пользователю.236Максимальная нагрузка группы выпуска документациинаступает в фазе программирования.

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

Это осуществляется путем участия в технической ревизионной комиссии.8.5.5 Организация выпуска документации в фазахоценки и использованияВ начале фазы оценки группа выпуска документации заканчивает составление окончательных вариантов всей документации вместе с иллюстрациями. Рукописи направляются нарассмотрение другим группам.

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

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

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

Каждое издание документации, каждая замена страницы и каждый перечень исправлений должны содержать указание на конкретнуювнешнюю спецификацию, и наоборот.8.5.6 Участие группы выпуска документациив фазовых обзорахДо фазового обзора I в группу выпуска документации поступает запрос на проведение предварительных оценок необходимых ресурсов, на основании которых производится распределение бюджета. Утверждение средств происходит в ходе фазового обзора II.В ходе фазового обзора II группа пересматривает свои исходные позиции в отношении соглашения о требованиях, руководствуясь окончательным бюджетом, и утверждает пересмотрен-238ное соглашение о требованиях. Проводится также анализ распределения бюджета внутри проекта, после чего группа выпуска документации утверждает расходы на печатную продукцию.

Аналогичным образом утверждается календарный план.Таблица 8.6 — Участие группы выпуска документации в фазовых обзорахФазовыйФорма участия при обсужденииФазаобзордокументовИсследованиеIРассмотрениеАнализIIРассмотрение и утверждениеосуществимостиКонструированиеIIIРассмотрениеПрограммированиеIVНе участвуетОценкаVНе участвуетИспользованиеVIНе участвуетДо фазового обзора III группа участвует в работе надвнешней спецификацией.

Ко времени фазового обзора III онадолжна изучить внешнюю спецификацию и убедиться, что вней правильно представлены интересы группы выпуска документации.В фазовом обзоре IV все внимание участников проектасосредоточено на передаче программ в распоряжение группыиспытаний. Группа выпуска документации участвует в этом обзоре лишь в том случае, когда для создания документации нужны дополнительные источники или если план выпуска документации нуждается в коррекции.В фазовом обзоре V группа выпуска документации участвует только в том случае, когда нужны ее рекомендации привыпуске изделия с недоработками.В фазовом обзоре VI основное внимание уделяется ослаблению поддержки изделия или ее полной отмене.

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