Особенности документирования...

О пользе документирования.

Мой отец всю жизнь занимался разведкой и хранением природного газа. Он стал кандидатом, затем доктором, профессором (полным), академиком и т.п. Он лауреат Государственных премий СССР и России. Регалий много, но и пользы народу немеряно. Многие подземные хранилища газа (ПХГ) у нас, на/в Украине, Германии, Чехии – его ума дело. Последние годы жизни, а это примерно лет 20-ть, он был одержим одной идеей. Воплощал он ее на компьютере, в форме программы на Excel.  Каждый день, приходя после работы, он до часа до двух ночи считал, высчитывал, записывал макросы, переделывал и т.п. Суть сводилась (как я, недоумок, понимаю) к тому, что для разработки газового  месторождения необходимо пробурить много скважин. Делается сетка, в каждом квадрате бурится скважина и по результатам выдается прогноз, сколько газа и за какой срок можно из земли добыть (отобрать). Чем больше скважин, тем точнее прогноз. А каждая скважина это (не буду врать, потому как разные они), но возьмем примерно 1 миллион долларов. Таких скважин бывает  100, бывает 200 и больше. Его же метод (открытие, изобретение…) позволял делать буквально следующее: берутся результаты геологоразведки (керны пород из уже пробуренных 3-4 скважин), пробуривается по рассчитанным его программой местам еще 3-4, по результатам еще пара и программа через сутки-двое дает расчет, сколько в месторождении газа, сколько конденсата, сколько можно отобрать и за какой срок. Экономия – миллиарды долларов.  Все бы хорошо, хотя на финальном этапе он стал беспокоиться за свою жизнь, потому как обнародуй он это все и многим странам, да и нашей, в том числе, такой фокус был бы не очень интересен. Так с миллиарда много миллионов украсть можно, а так посчитал железный шкаф с проводками и утю-тю… А где виноградники в Испании, да поместья в Сан-Францисках? Но не в этом дело. А дело в том, что каждая программа (компьютерная особенно) должна быть четко и пошагово задокументирована.  Должен быть описан каждый операнд, макрос и т.п. В Excel  это не очень просто, но можно. Я ругался с отцом до слюней, что надо все описывать. Все. Абсолютно все. Он сначала отмахивался, потом где-то года три пытался описать. Остались тома описаний. Тома! Примерно 40 килограмм. Но ничего абсолютно непонятно! АБСОЛЮТНО! Это тома инструкций, в которых может разобраться только разработчик. Сторонний наблюдатель это не поймет, будь он гений в газе, нефти и программировании.  Когда отец закончил работу, он светился. Труд всей жизни воплотился в рабочую версию, опробованную на разработанном им же месторождении, и показал блестящий результат. Вероятностная оценка подтвердила фактические результаты. Все! Можно было выступать на ученом совете. После ученого совета отец пришел постаревшим к своим 81 еще лет на сто… «Они ничего не поняли… Они не поняли ничего! Жить не хочется. Вся жизнь – к черту». Через примерно три месяца он умер.  Осталась программа, в которой никто не может работать. Остались тома документации, которые никто не может понять. И память. Память о великом труженике и ученом. 

А теперь случай из моей жизни. Я работал менеджером по продажам комплексных автоматизированных решений в госструктуры федерального уровня.  Сидим у Шефа на разборках. Вопрос (ну пусть ко мне):  «Какие дела у ЛПР в этом министерстве?» «Да все в отпуске. Затишье. Лето же» «Ну, хорошо. Понятно. Вася, а как у тебя?»  Вася: «ЛПР 14-го уехал в отпуск в Италию, на Лигурийское побережье. Генуя.  Самолет – бизнес класс. Отель 5 звезд. Бич Ройял.  Арендовал машину Ауди 4. Что интересно, он в этот раз взял с собой тещу. Прошлый раз он ее не брал. На время отпуска замом оставил Петра Петровича. 52 года, дважды женат. Трое детей. Коттедж в Поливаново. 3 этажа, кирпич. 2 машины. На него не зарегистрированы. Образование высшее – военное.  Звание полковник. Послужной список…Все описано и занесено в нашу контактную базу» Как вы думает, кто из нас продолжил работу на Шефа?

Вот что значит документирование информации.