о памяти и документации, русский перевод

[avva]

О памяти и документации, запись анонимного инженера-нефтехимика.

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

Очень рекомендую к прочтению, причем не только программистам (а им особенно).

P.S. Альтернативный перевод ahitech.

Comments

[postumia.livejournal.com]

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

[dibr.livejournal.com]

> a plant that refines some hydrocarbon type stuff into other hydrocarbon type stuff
> завод по очистке, допустим, карбогидратов в гидрокарбонаты

[бьясь головой об стол] "содиум" блин! "потассиум"! Как можно одни и те же углеводороды (hydrocarbon) перевести подряд сначала как "карбогидраты" (которые по русски на самом деле "углеводы", то есть по-простому сахарá), и тут же - как "гидрокарбонаты" (пищевую соду помним? так вот - это гидрокарбонат натрия)?! И это уже во втором абзаце, и в контексте, замечу, нефтехимии - какие там к чёрту углеводы и "гидрокарбонаты", это же не пищевая промышленность. Хотел дать ссылку у себя (англочитающих у меня мало, а по русски было бы интересно), но в таком виде - как-то желание отпало, вместе с желанием читать дальше.

И комментарии закрыты - даже нажаловаться автору перевода вроде как не получится :-/

[avva.livejournal.com]

Напишите ему здесь, пожалуйста :) я уверен, что он с радостью примет все замечания и исправит ошибки.

[oryx_and_crake]

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

[cema.livejournal.com]

"Допустим".

Я что, делаю технический перевод? Может быть, художественный?

Конечно, если настаиваете, могу юмор приглушить. Но без юмора пропадет содержание.

[http://users.livejournal.com/alh__/]

Только не углеводы, а углеводороды в данном случае.

[ilya-dogolazky.livejournal.com]

А в вашей конторе принято про программы писать сочинение на тему "как это всё работает" и ревьювить его людьми которые априори не знают как это всё работает?

[avva.livejournal.com]

Смотря что понимать под "ревьюить". У нас есть влиятельная и на мой взгляд очень хорошая традиция писать подробные design docs, объясняющие, зачем это надо и (в общих чертах) как это работает. Такой документ пишет инженер, работающий над проектом, чаще всего tech lead, хотя необязательно. Часто такие документы рассылают широкому кругу других инженеров, не имеющих прямого отношения к проекту, на случай, если их опыт подскажет им интересные пожелания, предложения что-то сделать по-другому, итд. Это тоже традиция. Это можно назвать "ревьюить". Но это не "ревью" в том смысле, что кто-то со стороны должен заверить документ и подписать его своим авторитетом, или что его замечания обязаны беспрекословно учитываться - такого нет.

[ban-dana.livejournal.com]

"А ведь этот ещё из лучших"... В смысле, это ещё про "настоящих" инженеров, которые делают настоящие вещи из настоящего железа, и все процессы обычно относительно строго документируются. Что уж говорить о наших виртуальных байтах, когда не всегда сам через месяц(!) можешь вспомнить, что это за хрень тут и зачем.

[3d-object.livejournal.com]

Да! И сидишь, как паук, среди альбомов и банок с DVD.
Что несколько сглаживает огорчение от потери объема рабочего места - когда раз в месяц звонит древний клиент и уверенно просит немедленно прислать ему работу 10-летней давности, ты знаешь, где ее искать.
А вот умрешь - и конец полимерам.

[(Anonymous)]

И еще. Раз я внешний консультант, мне нельзя доверить определенные секреты, описанные в этих документах. Только работники фирмы могут работать с этой секретной информацией и решать, что и как раскрывать перед внешними консультантами. К сожалению, как раз работники фирмы не знают секретов, а я знаю. Я даже придумал некоторые из них, на нескольких патентах мое имя. И вот мне надо занести эти секреты обратно на фирму, чтобы ее персонал мог с ними работать. Им надо только страться случайно не проговориться об этих секретах — при мне!

Почему-то вспомнилось любимое:

Папанин, с другой стороны, на льдине немного скучал. А чем дальше — тем больше скучал. Научных наблюдений он не вел, пищи, как начальник, не готовил, — он руководил. И еще проводил политинформации. Политинформации приходили так.
Кренкель принимал по радио последние известия, аккуратно переписывал их и вручал Папанину. Папанин брал листок в руки и простым доходчивым языком пересказывал остальным его содержание. Излишне упоминать, что Кренкелю полагалось в обязательном порядке присутствовать на политинформациях. Более того, как беспартийному, а следовательно — политически менее зрелому, чем остальные, ему рекомендовалось проявлять большую, чем товарищам-коммунистам, активность, и вести конспект. Конспекты потом Папанин проверял, и если было записано слишком кратко или неразборчиво — велел переписать.

[cema.livejournal.com]

Это, кажется, Веллер? У него правдоподобно, но не обязательно правдиво... Но написано бойко.

[saapin.livejournal.com]

=Раз я внешний консультант, мне нельзя доверить определенные секреты, описанные в этих документах=.
Вспомнилась история с Гинзбургом. Он был участником группы по разработке водородной бомбы. И придумал так называемую "лидочку". Потом из-за политически неблагонадёжной жены его выперли из группы. В результате ему не выдавали из секретного отдела его же собственные работы.

[a-bugaev.livejournal.com]

Спасибо, отличная история.

Добавлю - у программистов обычно есть вариант попытаться разобраться по исходникам. Аналог для того нефтехимического предприятия - найти чертежи (поскольку нельзя просто разобрать эту систему и посмотреть, что там внутри) и попытаться по ним понять, в чем смысл этой системы, каков замысел, какая заложена технология. Если кто-то на это способен, конечно.

Я, когда увидел слова про обратный промышленный шпионаж, сперва подумал, что там будет именно про
реверс-инжиниринг.

[cema.livejournal.com]

Он опустил эту часть, а жаль, было бы поучительно. (Собственно, это и есть археология.)

[alon_68]

А бывает, что исходники полностью или частично утеряны или устаревшие. Либо язык программирования - не очень популярный и позабытый, и компиляторов, работающих на современных компьютерах, не найти.

[emdin.livejournal.com]

Нет надежды, нет. Написанные мною дизайн-документы и how-tos уже никто не читает, потому что их слишком много. Поэтому сейчас я пишу краткое содержание уже существущей документации, со ссылками и ответы на часто задаваемые вопросы.

Их тоже никто не будет читать.

[nnimble.livejournal.com]

Почему-то программистов (которыми в некоторых регионах планеты уже лет десять как можно дороги мостить) до сих пор считают какими-то хрустальными сасутами чистого креатива, которых ни в коем случае не чапай. Вот кто-нибудь из них если решит себе дом построить, много свободы творчества предоставите прорабу и каменщикам? Просто набросает общий эскиз на салфетке, а там будь что будет? Ага.

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

Не могу понять, почему совковые клавонажиматели с major communication disfunction предпочитают забить на фазу проектирования, делать решение на коленке, порождать геморрой при приемке — и при этом считать себя чуть ли не богами, умнее аналитика и руководителя проекта.

да.

[mambaram.livejournal.com]

Каждый раз, попадая на новую работу, в новый коллектив - я наблюдаю броуновское движение эдаких Носителей Сакрального Знания по офису; соотношение Сакрального Знания, размазанного по сознательным Носителям к Сакральному Знанию на бессознательных носителях, а также redudancy первых и вторых однозначно характеризуют Начальство.

И да, очень часто, когда я пытаюсь что-то задокументировать или систематизировать, мне говорят, мол, не занимайся ерундой, работает - и Х с ним...

И да, я давно подумываю, что когда моя борода поседеет, я буду археологом - я для этой цели держу 5" флоповоды, например =)

[netch]

BTW, тема разобрана Севером Гансовским в рассказе "Часть этого мира". Самая показательная цитата:

- А здесь люди не работали. - Ниоль подняла палец. - То есть где-то
там, сзади, есть человеческий труд, но сама подземка спроектирована и
построена уже без участия человека. Теперь сама по себе развивается,
куда-то движется, обходит препятствия. Причем никто не знает, из каких
источников энергия. То есть раньше это было известно, конечно, а потом
кто-то умер, кто-то перешел в другую фирму. И получилось, что сейчас
дешевле предоставить ей самостоятельность, чем разыскивать, что откуда.
Потому что такие розыски - квалифицированный труд, дорогой.
- А если сломать? Взять да и взорвать какой-нибудь узел? Например,
депо. А то ведь она и под город подкопается.
- Сломать нельзя. Это же частная собственность. Правда, сейчас не
определить, чья именно, поскольку все ужасно запутано. А потом, не
очень-то сломаешь, она ведь сама чинится, ремонтируется. И наконец, кто
этим будет заниматься? Вы же не придете сюда со взрывчаткой, и я не приду.
Поэтому проще ее забыть или считать как бы природным явлением... Да и
вообще ее потеряли. Сейчас только редкие знают, где она. Я расскажу в
отделе, что ездила тут, на меня вот такими глазами станут смотреть.

[gaz-v-pol.livejournal.com]

На праздновании "в узком кругу" пятнадцатилетия (всего-то пятнадцатилетия!) запуска "Энергии-Бурана" я с удивлением узнал, что сохранились лишь бумажные рулоны распечаток на АЦПУ-128 с выборками из данных бортовой и наземной телеметрии, позволяющие частично воссоздать ход исторического полета. Данные о ходе полёта, которые не были распечатаны на бумаге, практически потеряны, так как магнитные ленты для БЭСМ-6 сегодня прочесть не на чем. Последняя БЭСМ-6 на Московском вертолетном заводе была демонтирована в 1995 году.

http://offline.computerra.ru/print/offline/2007/702/333801/

[cema.livejournal.com]

БЭСМ демонтирована, но живет проект виртуальной машины. Надо только научиться подключать настоящие дисководы. (Это может быть нелегко.) Update: впрочем, такие работы идут, см. https://groups.google.com/forum/#!forum/besm6

Update: на картинке БЭСМ-6 в 2009 году, см. http://en.wikipedia.org/wiki/BESM#BESM-6

[jambojet.livejournal.com]

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

Так как все банковские системы создавались еще в 80-х, а некоторые и в 70-х.
Потом на них наворачивались новые функции, интерфейсы.

А ядро осталось тем же самым, оно работает с помощью эмуляции на весьма пожилом железе (начала 2000-х), а код его даже прочитать никто не может.
Там же указывалось, что переход на современные системы (вроде бы масштаба Wells Fargo) обойдется в 800млн долларов, и будет сопряжен с большим риском. Поэтому менеджеры каждый год принимают решение "работает - не трогай", получают свои бонусы, и откладывают модернизацию на будущее. И снова. И снова.

А еще вспомнилось, как недавно NASA покупало процессоры типа 386SX на ебей и искало на руках, так как многие системы еще с того времени, а производителей, ясное дело, запчастей не купишь.
Только каннибализм старых устройств )

в комментах не вспомнили, добавлю

[vekk.livejournal.com]

---
Как-то раз, несколько лет назад, понадобились нам планы зданий штаб-квартиры Microsoft в Редмонде — подошло время думать об очередном этапе строительства. Но часть из них нигде нельзя было найти. Обратились к человеку, долгое время возглавлявшему у нас соответствующую службу. Он только что вышел в отставку, поэтому пришлось звонить ему домой. Он направил нас к электрику, который — к счастью — по-прежнему продолжал работать на одного из наших поставщиков. Все завершилось благополучно — планы у электрика нашлись; но ведь он оказался, по существу, единственным в мире человеком, у которого были планы всех наших зданий.
---
Билл Гейтс Бизнес со скоростью мысли

http://adidasxue.blogspot.jp/

[(Anonymous)]

http://アディダススニーカアディダススポーツ.blogspot.jp/
[url=http://adidaserdsw.blogspot.jp/]adidas 靴[/url]
http://adidassrgtfgg.blogspot.jp/
http://adidasxue.blogspot.jp/
http://adidaserdsw.blogspot.jp/
[url=http://アディダスメンズアディダスtシャツ.blogspot.jp/]アディダス メンズ[/url]
[url=http://adidashgsdje.blogspot.jp/]アディダス[/url]
http://adidasjdskas.blogspot.jp/
[url=http://adidasjdskas.blogspot.jp/]アディダス 帽子[/url]
[url=http://adidasxue.blogspot.jp/]adidas 腕時計[/url]
http://ディダスtシャツアディダスジャケット.blogspot.jp/
[url=http://adidaswan.blogspot.jp/]adidas 腕時計[/url]
http://adidaswan.blogspot.jp/
http://sdjfhksdjfhklljkfd.blogspot.jp/
http://アディダスメンズアディダスtシャツ.blogspot.jp/
[url=http://sdjfhksdjfhklljkfd.blogspot.jp/]アディダス 靴[/url]
[url=http://ディダスtシャツアディダスジャケット.blogspot.jp/]アディダス ジャケット[/url]
http://adidashgsdje.blogspot.jp/
[url=http://adidassrgtfgg.blogspot.jp/]adidas ランニング[/url]
[url=http://アディダススニーカアディダススポーツ.blogspot.jp/]アディダス スポーツ[/url]