|
Жизненный цикл документов |
Далее описывается полный цикл жизни документов в составе документации 3ОС, с момента поступления на обсуждение и до передачи в архив. Вводятся новые понятия: проекты документов, отвергнутые документы и "прочность". Можно сказать, что данный документ является несколько запоздавшей интерпретацией первоначальных идей печки, предложенных Давидом.
В соответствии с данными правилами, документация 3ОС делится на следующие основные разделы:
Внутри каждого из основных разделов документы группируются согласно тематике, закрепленной в "Каталогах документации 3ОС". Перечисленные выше основные разделы документации являются виртуальными, т. е. не соответствуют физическим каталогам на носителях. Поскольку на момент разработки и принятия настоящих правил каталоги документации 3ОС уже сформированы, их перепланировка и последующий перенос документов сопряжены с большими накладными расходами, и поэтому признаны нецелесообразными. Вместо этого рекомендуется доработать структуру каталогов, описанную в "Каталогах документации 3ОС", чтобы она соответствовала реальности.
Физически основные разделы документации реализуются в виде страниц оглавления, по одной странице на каждый раздел. При этом начальной страницей документации будет не оглавление действующих документов, как сейчас, а страница со ссылками на основные разделы.
Помимо нахождения внутри определенного раздела, соответствующего той или иной ступени в жизненном цикле документа, каждый документ 3ОС обладает двумя дополнительными свойствами, независимыми друг от друга:
Прочность документа является параметром, объективно определяющим его достоверность, нужность и соответствие остальным документам в пакете документации 3ОС. Прочность обозначается числом от 0 до 5, где 0 - полное отсутствие прочности, а 5 - максимальная прочность, незыблемость концепций, выраженная в числовом виде.
Прочность документа увеличивается или уменьшается на единицу при каждом удачном или неудачном обсуждении соответственно. "Обсуждение" в данном контексте можно понимать как "чтение", проводя аналогию с обсуждением законов в парламенте.
Порогом вхождения документа в состав принятых к исполнению (действующих) является прочность, выражаемая числом 2. Документы, имеющие прочность ниже этой отметки могут находиться только в составе проектов документов или отвергнутых. Предлагаемый ниже механизм обсуждения и принятия документов опирается на изложенные здесь положения о прочности.
Признак помещения документа в архив, или архивированность, является независимым признаком, никак не влияющим на прочность документа. В соответствии с логикой, документ может или не может быть помещен в архив, соответственно, может иметь или не иметь признака архивированности. Выражаясь алгоритмическим языком, скажем, что архивированность документа является логическим (булевым) свойством.
Далее будут описаны свойства документов, хранящихся в каждом из основных разделов, а также правила их перевода из одного раздела в другой с соответствующим изменением свойств.
Как следует из названия, в данном разделе хранятся документы, еще не являющиеся принятыми, и находящиеся на стадии обсуждения. Атрибут архивированности для этих документов не установлен. Прочность документов в данном разделе устанавливается в соответствии с правилами изменения статуса документов, описанными ниже.
Опираясь на свойства, изложенные выше, можно дать следующее определение действующим документам: действующими являются документы, имеющие прочность не менее 2 и не являющиеся архивированными.
В соответствии с правилами, действующие документы выносятся на повторное обсуждение или доработку с сохранением первоначальной прочности.
Отвергнутыми считаются документы с прочностью ниже 2 и не имеющие признака архивированности. В раздел отвергнутых могут быть переведены как новые, не получившие одобрения, так и ранее действовавшие документы, потерявшие прочность в процессе обсуждения.
Архивированными считаются документы любой прочности, имеющие признак помещения в архив. Как было сказано выше, при архивировании документа его прочность не изменяется.
В соответствии с настоящими правилами, обсуждаться могут только проекты документов. Они могут быть следующих типов:
Прочность обсуждаемых документов распределяется следующим образом:
Как было сказано выше, прочность документа увеличивается в случае принятия и уменьшается в случае отказа. Таким образом, новые (или отвергнутые) документы могут поднять свою прочность до двух и войти в состав действующих документов, или понизить ее до нуля, и перейти (или вернуться) в разряд отвергнутых.
Если действующий или восстановленный из архива документ после неудачного обсуждения по-прежнему имеет прочность выше двух, он возвращается в состав действующих с новой, пониженной прочностью. Если же прочность ранее действовавшего документа опускается ниже двух, документ переходит в разряд отвергнутых.
Сроки применимы только к процессу обсуждения документа. Настоящими правилами сроки непосредственного обсуждения не ограничиваются. Но, если в течение одного месяца после вынесения проекта документа фактическое его обсуждение так и не началось, документ считается отвергнутым.
На момент принятия данных правил все существующие и не отвергнутые документы 3ОС получают прочность, равную 2, а архивированные документы также получают признак архивированности.
Технически для приведения документации в новый вид нужно создать страницы для новых разделов и новую начальную страницу всей документации.
Рекомендуется также вытащить из архивов 3ОС отвергнутые ранее документы и поместить их в соответствующий раздел.
Ответственность за своевременное проведение работ по обновлению документации возлагается на ответственного за ведение документации.