12 Документация

12

Документация

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

Но вначале поговорим о том, почему мы не любим, боимся и вообще избегаем составлять документацию.

Мы с настороженностью относимся к любой просьбе задокументировать то, чем мы занимаемся, потому что она звучит как признак грядущего увольнения. Если мы будем документировать свою деятельность, то нас смогут заменить кем-то другим. Иногда просьба все документировать исходит извне группы системного администрирования, обычно от того, кто излишне беспокоится по поводу стандарта ISO 9001 и не понимает, что процессы документирования ведут в тупик, а не в обход.

Очень трудно приступить к составлению документа. Слово «документация» ассоциируется у нас с тысячестраничной книгой, в которой описано то, чем мы занимаемся, как именно мы это делаем и вообще как все работает. Ну и с чего прикажете начать, если вдруг придется это описывать?

Системные администраторы, как правило, перфекционисты. Мы не в состоянии задокументировать все. Зачем начинать проект, если он никогда не будет закончен? Написание документации требует столько времени, что она нередко устаревает уже в процессе написания. Зачем составлять документ, который будет бесполезен, когда мы его закончим?

Кроме того, у наших дверей всегда толпятся клиенты с неотложными просьбами, которые, как правило, важнее документирования. При написании документации нужно долго работать, не отвлекаясь. У какого системного администратора есть такая возможность?

Наконец, профи ненавидят печатную документацию. Зачем дразнить гусей?

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