Группа - выпуск - документация
Cтраница 1
Группа выпуска документации может самостоятельно решать некоторые проблемы, не имеющие непосредственного отношения к производству программных изделий, например осуществлять защиту авторских прав, участвуя в экспертизе и утверждении документов вместе с другими заинтересованными сторонами, такими, как юридический отдел фирмы. Другой пример касается вопроса, в какой форме следует издавать документацию: в виде книг в переплете или в виде папки со свободно вынимающимися листами. Еще одна задача возникает уже в процессе распространения программного изделия: в многонациональной фирме предпочтительнее рассылать в разные страны типографские матрицы доку ментации, вместо того чтобы заниматься рассылкой большого количества бумажной продукции. [1]
Группа выпуска документации начинает участвовать в работе над программным изделием в рамках фазового обзора I, выполняя предварительную оценку стоимости издания документации. Для этого приходится принимать некоторые предположения относительно вида документации, времени издания и расценок. Чем определеннее составлены стандарты оформления документации, тем точнее окажутся оценки, полученные в этой фазе. Если, например, для транслятора с РПГ решено выпустить справочное руководство, руководство оператора и указатель сообщений, то этого уже достаточно, чтобы более менее точно рассчитать затраты на выпуск документации. [2]
Если группа выпуска документации не планирует издание каких-либо материалов, отличающихся от стандартных, то для экспертов, изучающих соглашение о требованиях, будет достаточно рассмотреть в этом соглашении простую таблицу, рекомендуемую в гл. [3]
Положение группы выпуска документации внутри проектной организации зависит от характера и объема выполняемых работ. Как показано а рис. 9.1, в фирме ABC Computers имеется группа, которая обеспечивает выпуск документации на технические и программные средства. Из рис. 3.2 видно, что эта группа находится в составе отдела сбыта. [4]
Относительные трудозатраты группы выпуска документации ( рис. 9.3) достигают максимума в фазе программирования, когда эта группа изучает план группы поддержки, чтобы убедиться в том, что рукописи или уже изданные материалы, необходимые для обучения пользователей или служащие в качестве источника для создания рекламных материалов, появятся к заданному сроку. Работа по составлению рукописей, начатая в фазе конструирования, достигает максимума в фазе программирования. [5]
 |
Участие группы выпуска документации в фазовых обзорах. [6] |
Утверждение последнего группой выпуска документации необходимо потому, что к этому времени выясняется необходимость в подготовке специальных документов, выходящих за рамки стандартных справочных материалов. Проводится также анализ распределения бюджета внутри проекта, после чего группа выпуска документации утверждает расходы на печатную продукцию. Аналогичным образом утверждается календарный план, учитывающий потенциальные возможности группы выпуска документации. [7]
В фазе программирования группа выпуска документации представляет на рассмотрение ряд вариантов справочных материалов. В середине фазы программирования группой испытаний представляются для рассмотрения спецификации испытаний. Группа разработки тщательно изучает варианты документации и спецификации испытаний с тем, чтобы в них не было ошибок, порожденных неверными исходными предположениями. Если группа разработки в свое время подготовила корректные внешние спецификации, то их анализ не вызовет больших затруднений, хотя и займет немало времени. Если же некоторые положения внешних спецификаций пропущены или изложены недостаточно полно, то их проверка не только отнимет много времени, но и вызовет большие трудности. В этом случае придется изменять внешние спецификации, что может свести на нет запас времени, имеющийся в календарном плане проектирования. [8]
Для осуществления деятельности группы выпуска документации большое значение имеет установление и соблюдение стандартов, регулирующих работу редакционной и производственной бригад. [9]
Описание методов работы группы выпуска документации, изложенное в последующих разделах, применимо к любой организационной форме выпуска печатной продукции, даже если эта функция рассредоточена по различным организационным подразделениям. [10]
Стратегию и процедуры группы выпуска документации следует трактовать в соответствии с приведенными в разд. Если все же возникает необходимость изменить какие-то формы, то изменение должно вноситься по возможности в новую серию программных изделий. [11]
 |
Кривая относительных трудозатрат группы выпуска документации. [12] |
В течение этой фазы группа выпуска документации один или несколько раз передает на рассмотрение группы разработки рукописи справочных материалов, с тем чтобы прежде всего выявить расхождения в технических деталях проекта. Обсуждение материалов проводится в рабочей обстановке, что положительно сказывается на взаимоотношениях между редакторами и разработчиками. [13]
В самом начале фазы оценки группа выпуска документации заканчивает составление окончательных вариантов всей документации вместе с иллюстрациями. Рукописи направляются на рассмотрение другим группам. В изучении рукописей принимают обязательное участие группы разработки, испытаний и поддержки. В частности, группа испытаний проверяет эти рукописи таким же образом, как и программное изделие: она сверяет содержание документов со спецификациями и проверяет их на соответствие. Группа испытаний подготавливает перечень дефектов, замеченных как в документации, так и в программном изделии ( см. разд. Группа выпуска документации должна принять решение: либо устранить обнаруженные - недостатки, либо привести доводы в пользу существующей редакции материалов. [14]
Этот список включает как основные документы группы выпуска документации, так и вспомогательные материалы, упоминаемые в документах и планах организации поддержки. Сообщается вся информация, необходимая для однозначной идентификации приводимых в списке материалов. [15]
Страницы: 1 2 3 4