Это делает возможным введение иерархии в структуру процедуры. Можно представить три части описания в одном, двух или трех документах в зависимости от объема описаний и круга их читателей. Например, только что упомянутый раздел Стратегия документа НТИ рассчитан на изучение в рамках всей организации, в то время как разделы Формы и Процедуры могут быть ориентированы на соответствующие конкретные подразделения. В рассматриваемой корпорации AB документ НТИ содержит отдельные разделы Формы для аппаратуры и программных изделий, а также предусматривает разные процедуры для отделов и секторов фирмы. [c.331]
В гл. 9 отмечается необходимость использования стандартов в работе группы выпуска документации. В разд. 9.2, в частности, упоминалось о руководстве по стилю документации и целесообразной стратегии в вопросах документирования разработок. Стратегию и процедуры группы выпуска документации следует трактовать в соответствии с приведенными в разд. 17.2 определениями. Однако формы документов этой группы подобны стандартам, т. е. необходимо строго следовать им и редко вносить в них изменения, с тем чтобы пользователи всегда имели точное представление о содержании изданных документов. Если все же возникает необходимость изменить какие-то формы, то изменение должно вноситься по возможности в новую серию программных изделий. Следуя рекомендациям разд. 9.2, можно составить руководство по стилю публикаций, в которое должны быть включены все формы и стандарты на издание материалов. Моменты, которые должны быть отражены в этом руководстве, приведены в табл. 17.3. [c.345]
Как указано выше, продуманная система процедур дает не только ясное представление о том, какие ставятся цели, но и обоснование причин и способы достижения целей. Эти вопросы удобно излагать в отдельных разделах что — в разделе Формы , как — в разделе Процедуры и зачем — в разделе Стратегия . Каждый документ, описывающий процедуру, следует начинать с описания, для чего требуется эта процедура, что она собой представляет, и, наконец, как она выполняется. Например, фирма AB omputers в разделе Назначение документа Назначение и требования к изделию (НТИ) указывает, зачем фирме требуется этот документ в разделе Формы указывает на описание, подобное представленному в гл. 13 данной книги, которое определяет, что содержит рассматриваемый документ. В разделе Ответственность описано, как документ используется на этапах формирования, рассмотрения и утверждения, и даны ссылки к другим документам. [c.330]
Какуказано в разд. 17.1, описания процедур должны быть легко доступны. Добиться этого, обеспечив к тому же совместное хранение, можно, снабдив каждого сотрудника справочником, содержащим все необходимые сведения о стратегии, процедурах, формах документов и стандартах, которые требуются ему для выполнения работы. В зависимости от количества материалов, нужных каждому сотруднику, и способа их оформления можно составить несколько томов. Удобно сделать отдельные тома для данной организации, сектора и отдела, разделить финансовые, кадровые и технические данные или же составить один том, включающий отдельные разделы для разных сфер применения. Однако объем материалов, предназначенных для каждого сотрудника, хотя и должен быть достаточным для выполнения его работы, но не должен быть излишне большим. Справочник по процедурам ни в коем случае не должен стать самодовлеющим материалом он должен лишь способствовать успешному продвижению работы. [c.331]