Деятельность, связанная с разработкой изделия, достигает своего пика в фазе программирования, когда планы испытаний дополняются спецификациями испытаний. Внутренняя структура изделия полностью описывается внутренней спецификацией, которая содержит сведения о том, как строится изделие, как формируется план обеспечения функционирования программного обеспечения и становятся доступными аппаратные ресурсы. В то время как группа разработки преобразует внешний и внутренний проекты в основное тело программ, т. е. в начальное воплощение изделия, группа испытаний трансформирует их с помощью спецификации испытаний в контрольные примеры группа выпуска документации создает справочные материалы группа поддержки программного обеспечения создает рекламные материалы и материал для обучения персонала. Эти последние действия начинаются с середины фазы программирования и продолжаются почти до конца фазы оценки. В самом конце фазы оценки группа обслуживания подготавливает руководство по вводу программного обеспечения в действие, называемое информационным листком выпуска, и вместе с группой сопровождения заносит в сопроводительную документацию все, что потребуется в будущем. Фаза использования начинается тогда, когда изделие объявлено готовым к передаче пользователям. Все, что остается после этого на рис. 2.3, — это периодическое создание корректирующих программ, предназначенных для исправления ошибок, обнаруженных пользователями, и обеспечения функционирования изделия в реальных условиях эксплуатации. [c.34]
Теперь рассмотрим возможность решения проблемы обеспечения условий для продвижения по службе. Целесообразно учредить несколько должностных инстанций, таких, как ассистент инженера по программному обеспечению, инженер, старший инженер, ведущий инженер, с альтернативными назначениями для инженера, такими, как эксперт (в группе испытаний), редактор (в группе выпуска документации), аналитик (в группе поддержки). Необходимо составить формальные должностные инструкции, определяющие соответствующее повышение ответственности и устанавливающие одинаковый уровень квалификации для должностей одного уровня. Например, если должность старшего инспектора по программному обеспечению требует 10-летнего стажа работы на ответственных постах, то аналогичные требования должны быть установлены и для должности старшего редактора. [c.58]
Если программное изделие предназначено для многих пользователей, целесообразно выбрать одного или двух из них для поставки им бесплатно и с полной поддержкой опытного образца изделия при этом пользователи будут настолько польщены подобным выбором, что обеспечат отдачу, значительно превышающую стоимость поставки опытного образца изделия. К рабочим испытаниям опытного образца изделия полезно привлечь группу испытаний. Персонал этой группы получит возможность усовершенствовать свои тестовые программы и процедуры, основываясь на экспериментальных данных. Это касается также и группы выпуска документации, сотрудники которой смогут намного улучшить качество документации пользователя после проверки в действии своих первых решений. [c.74]
По окончании фазы исследований группа планирования первым делом рассматривает и утверждает планы организации поддержки для каждого изделия или совокупности изделий. В течение всей фазы конструирования группа выпуска документации и группа испытаний готовятся к рассмотрению плана изданий документов и плана испытаний. Группа планирования (обычно под руководством администратора планирования) анализирует эти планы главным образом на их соответствие предписываемым формам и совместимость с соглашением о требованиях, конфигуратором и планом выпуска программного изделия. В течение фазы программирования группа поддержки готовит свой план, а группа планирования рассматривает его в том же порядке, в каком до этого рассматривались план изданий и план испытаний. [c.79]
В фазе программирования группа выпуска документации представляет на рассмотрение ряд вариантов справочных материалов. В середине фазы программирования группой испытаний представляются для рассмотрения спецификации испытаний. Группа разработки тщательно изучает варианты документации и спецификации испытаний с тем, чтобы в них не было ошибок, порожденных неверными исходными предположениями. Если группа разработки в свое время подготовила корректные внешние спецификации, то их анализ не вызовет больших затруднений, хотя и займет немало времени. Если же некоторые положения внешних спецификаций пропущены или изложены недостаточно полно, то их проверка не только отнимет много времени, но и вызовет большие трудности. В этом случае придется изменять внешние спецификации, что может свести на нет запас времени, имеющийся в календарном плане проектирования. [c.113]
В то время как группа испытаний проводит испытания класса В, группа выпуска документации представляет на рассмотрение справочные материалы. Группа разработки имеет последнюю возможность исправить ошибки в этих материалах, и поэтому их рассмотрение должно проводиться особенно тщательно. Группа выпуска документации учитывает замечания разработчиков и проводит последний просмотр материалов перед сдачей их в печать. Во время последнего просмотра группа разработки может исправить только типографские опечатки любые другие изменения задержат выпуск справочных материалов. [c.115]
Следует также различать рекламные и справочные материалы, потому что, во-первых, они предназначены для разных категорий читателей, а, во-вторых, при их создании ставились разные цели. Рекламные материалы предназначены преимущественно для административного персонала, в то время как справочные материалы используются операторами, программистами и системными аналитиками. Группа поддержки составляет рекламные материалы в рамках своей деятельности, связанной со сбытом, а изготовление справочных материалов, как будет показано в этой главе, входит в обязанности группы выпуска документации. На практике можно объединить выпуск материалов обоих видов, однако различие в их назначении следует всегда учитывать. [c.135]
Организационная структура группы выпуска документации [c.135]
Указанные выше цели можно достичь, создав такое организационное подразделение, в котором могут работать бригады редакторов и производственные бригады. Редакторы могут быть прикреплены к конкретному проекту индивидуально или"бригадами и иметь самое различное служебное положение как в рамках функции выпуска документации, так и по отношению к опекаемым ими группам разработки. Цели группы выпуска документации должны быть направлены на создание эффективного рабочего взаимодействия с группой разработки. В то же время производственная бригада должна находиться целиком в подчинении группы выпуска документации. В эту бригаду входят технические редакторы, корректоры, машинистки, художники, граверы, чертежники, фотографы — широкий контингент специалистов, из которых создается коллектив, спаянный общими деловыми интересами. Эти сотрудники нуждаются в квалифицированном руководстве, которое должно помочь им выработать и сохранить в дальнейшем свой стиль оформления документации точно так, как это делают редакторы. [c.136]
Для осуществления деятельности группы выпуска документации большое значение имеет установление и соблюдение стандартов, регулирующих работу редакционной и производственной бригад. [c.136]
Руководитель группы выпуска документации [c.137]
Создание стандартов может быть поручено одному или нескольким аналитикам группы выпуска. Один из вариантов организационной структуры группы выпуска документации приведен на рис. 9.1. [c.138]
Описание методов работы группы выпуска документации, изложенное в последующих разделах, применимо к любой организационной форме выпуска печатной продукции, даже если эта функция рассредоточена по различным организационным подразделениям. [c.138]
По мере расширения круга лиц, взаимодействующих с программными изделиями в интерактивном режиме, появляется все больше возможностей оперативно выводить справочную информацию. В большинстве интерактивных систем выдается (и так должно быть во всех системах) довольно много сообщений-подсказок и сообщений об ошибках, и поэтому пользователь может продолжать работу с программным изделием, даже если возникнет непредвиденная ситуация. Группа разработки проектирует лишь программные механизмы подобного взаимодействия с пользователем, однако ответственность за окончательную редакцию текста сообщений, их стиль и форматы несет группа выпуска документации. Она также проверяет соответствие печатных материалов сообщениям, выдаваемым в режиме онлайн. [c.140]
Группа выпуска документации может самостоятельно решать некоторые проблемы, не имеющие непосредственного отношения к производству программных изделий, например осуществлять защиту авторских прав, участвуя в экспертизе и утверждении документов вместе с другими заинтересованными сторонами, такими, как юридический отдел фирмы. Другой пример касается вопроса, в какой форме следует издавать документацию в виде книг в переплете или в виде папки со свободно вынимающимися листами. Еще одна задача возникает уже в процессе распространения программного изделия в многонациональной фирме предпочтительнее рассылать в разные страны типографские матрицы доку ментации, вместо того чтобы заниматься рассылкой большого количества бумажной продукции. [c.141]
Группа выпуска документации начинает участвовать в работе над программным изделием в рамках фазового обзора I, выполняя предварительную оценку стоимости издания документации. Для этого приходится принимать некоторые предположения относительно вида документации, времени издания и расценок. Чем определеннее составлены стандарты оформления документации, тем точнее окажутся оценки, полученные в этой фазе. Если, например, для транслятора с РПГ решено выпустить справочное руководство, руководство оператора и указатель сообщений, то этого уже достаточно, чтобы более менее точно рассчитать затраты на выпуск документации. [c.141]
В фазовом обзоре I начинает рассматриваться извещение о календарных сроках. В системе планирования и управления должно быть предусмотрено по крайней мере одно событие, относящееся к функции выпуска документации. На этом этапе необязательно готовить подробный план выпуска документации, так как начало и конец периода деятельности группы выпуска документации довольно точно определяются сроками выполнения работ в рамках других функций. На рис. 9.2 приведен сетевой график работы группы выпуска документации. После фазового обзора I эта группа фактически перестает участвовать в проекте вплоть до утверждения соглашения о требованиях. [c.141]
| Рис. 9.2. Стандартный сетевой график работы группы выпуска документации. |  |
В период между составлением соглашения о требованиях и его утверждением на этапе фазового обзора II все заинтересованные группы должны оценить требования к программному изделию и его возможности. Хотя группа выпуска документации привлекается лишь для консультаций при составлении соглашения, она тщательно изучает его, чтобы убедиться, что ее обязательства соответствуют назначению программного изделия. [c.143]
Стандартный сетевой график, приведенный на рис. 9.2, отражает основные виды деятельности группы выпуска документации и их связь с деятельностью других групп. Эти виды деятельности, число которых может быть увеличено, если возникнет необходимость выпуска разнообразной документации и рассмотрений анализов ранних редакций материалов, могут служить основой для составления плана выпуска документации. [c.145]
В фазе конструирования группа разработки передает внешнюю спецификацию на рассмотрение другим группам. Группа выпуска документации убеждается в том, что внешняя спецификация имеет завершенный вид, и начинает готовить рукописи справочных материалов. Если в документацию включено техническое описание системы, то работу целесообразно начать именно с этого документа, так как он должен быть готов примерно в то время, когда группа поддержки выпустит рекламные материалы (см. рис. 9.2). [c.145]
Если программное изделие должно обеспечивать выдачу справочной информации в онлайновом режиме, группа выпуска документации совместно с группой разработки подготавливает внешнюю спецификацию на изделие, в которой описываются форматы и содержание всех сообщений, выдаваемых пользователю. Группа выпуска документации может предложить свой способ оформления таких сообщений, оговорив в соответствующем руководстве принципы организации справочных материалов. В этом случае взаимодействие этой группы с группой разработки оказывается весьма плодотворным. [c.145]
Относительные трудозатраты группы выпуска документации (рис. 9.3) достигают максимума в фазе программирования, когда эта группа изучает план группы поддержки, чтобы убедиться в том, что рукописи или уже изданные материалы, необходимые для обучения пользователей или служащие в качестве источника для создания рекламных материалов, появятся к заданному сроку. Работа по составлению рукописей, начатая в фазе конструирования, достигает максимума в фазе программирования. Редакторы часто вступают в контакты с разработчиками и участвуют в со- [c.145]
| Рис. 9.3. Кривая относительных трудозатрат группы выпуска документации. |  |
С момента утверждения внешней спецификации (в начале фазы программирования) и вплоть до начала испытаний класса В (в конце фазы программирования) группа выпуска документации следит за всеми изменениями внешней спецификации, происходящими в течение фазы программирования. Хотя эта группа и при- [c.146]
В самом начале фазы оценки группа выпуска документации заканчивает составление окончательных вариантов всей документации вместе с иллюстрациями. Рукописи направляются на рассмотрение другим группам. В изучении рукописей принимают обязательное участие группы разработки, испытаний и поддержки. В частности, группа испытаний проверяет эти рукописи таким же образом, как и программное изделие она сверяет содержание документов со спецификациями и проверяет их на соответствие. Группа испытаний подготавливает перечень дефектов, замеченных как в документации, так и в программном изделии (см. разд. 10.8). Группа выпуска документации должна принять решение либо устранить обнаруженные -недостатки, либо привести доводы в пользу существующей редакции материалов. [c.147]
Если группа испытаний удовлетворена содержанием рукописей, последние сдаются в печать и готовая документация поступает на распространение. Решение об издании материалов обычно принимается раньше, чем будет рекомендован выпуск программного изделия. Поэтому группа выпуска документации имеет большой запас времени для обеспечения высокого качества печатной продукции. [c.147]
В фазе оценки группа обслуживания подготавливает руководство по вводу программного изделия в действие — информационный листок выпуска. Этот листок создается в соответствии со стандартами группы выпуска документации, которая и обеспечивает его выход в свет. Группа выпуска документации привлекается к обсуждению решения руководства фирмы о выпуске изделия, если предложены рекомендации оставить без исправления замеченные в документах дефекты. Такая рекомендация может быть сделана только в том случае, если бы устранение дефектов при- [c.147]
Участие группы выпуска документации в фазовых обзорах [c.148]
Еще до начала фазового обзора I в группу выпуска документации поступает запрос о проведении предварительных оценок не-1 обходимых ресурсов, на основе которых производится распреде- ление бюджета. Как уже говорилось в разд. 9.3, для этих целей можно использовать стандартные расценки, а утверждение средств отложить до фазового обзора II, когда можно будет уточнить конкретные статьи расходов. Поэтому группа выпуска документации анализирует лишь окончательное распределение бюджета. [c.148]
| Таблица 9.2 Участие группы выпуска документации в фазовых обзорах |  |
В фазовом обзоре IV все внимание участников проекта сосредоточено на передаче программ в распоряжение группы испытаний. Группа выпуска документации участвует в этом обзоре лишь в том случае, когда для составления материалов нужны дополнительные источники или если план выпуска документации нуждается в корректировке. В фазовом обзоре V группа выпуска документации участвует только в том случае, когда необходимы ее рекомендации относительно выпуска изделия с недоработками. При этом всестороннему обсуждению подвергаются все аргументы за и против соблюдения календарных сроков и оценивается ущерб, наносимый качеству программного изделия. В фазовом обзоре VI основное внимание сосредоточено на проблеме ослабления поддержки программного изделия или ее полной отмены. К этому времени изменения в документации настолько незначительны, что становятся частью деятельности группы сопровождения, и поэтому группа выпуска документации в фазовом обзоре VI не участвует, [c.149]
В то время как группа поддержки составляет план обеспечения поддержки, группа выпуска документации работает над планом выпуска печатной продукции. На рис. 11.3 приведен стандартный сетевой график работ группы поддержки изделия в ходе проектирования. Как видно из рисунка, группа выпуска документации представляет свой план на обсуждение несколько раньше группы поддержки. Поэтому последняя имеет возможность заблаговременно ознакомиться с планом выпуска документации. Она должна убедиться, что запланированные к выпуску материалы смогут обеспечить обучение пользователей, ввод в действие и использование программного изделия, а также содержат необходимую справочную информацию как для пользователей, так и для осуществления функции поддержки. При этом особое внимание уделяется плановым срокам представления документации, так как [c.180]
По мере внесения расширяющих и корректирующих изменений растет объем работы, связанной с ведением документации и выпуском печатных материалов, что вынуждает назначить руководителя, ответственного за координацию разнообразных видов деятельности по сопровождению, подобно тому как это делает руководитель проекта во время разработки изделия. Данный руководитель может быть выделен из штата группы обслуживания, если именно она, как описано в гл. 8, осуществляет административное управление сопровождением. Проводя усовершенствование изделия, следует принять меры предосторожности, чтобы не внести в него слишком большое число изменений, что неминуемо приведет к игнорированию эффективного механизма фазовых обзоров и к отставанию в работе группы выпуска документации, группы испытаний и даже группы поддержки по подготовке к освоению новой версии программного изделия. [c.193]
Указываются шифр или шифры изделия, присвоенные в соответствии с требованиями удобства управления его конфигурацией. Если предполагается выпуск печатных изданий и разработка планов поддержки, порядок присвоения шифров конечным результатам работы группы выпуска документации и группы поддержки может быть иным. [c.207]
Этот список включает как основные документы группы выпуска документации, так и вспомогательные материалы, упоминаемые в документах и планах организации поддержки. Сообщается вся информация, необходимая для однозначной идентификации приводимых в списке материалов. [c.298]
| Рис. 9.1. Организационная структура группы выпуска документации в фирме AB omputers. |  |
В утвержденном соглашении о трсоовакиях к зивистсл, киКие виды документации надо издать, когда они будут готовы и в каких формах выражается дополнительное участие группы выпуска документации в работе над программным изделием. Если эта группа изъявляет желание участвовать в рассмотрении внешней спецификации на изделие, она может быть включена в техническую ревизионную комиссию. [c.143]
Начать использование программы контроля эффективности испытаний класса В операционной системы VSOS версии 4.0 с целью демонстрации способа обращения с этим средством. Руководитель группы выпуска документации [c.237]