Ветки персика из Лос-Аламоса

Apr 25, 2006 22:36

Люблю, говорю, хорошую документацию. Такую, чтобы не было противно читать живому человеку, вменяемую и внятную. А то ведь оно всяко бывает... ( ;-) )

story, Цепочка

Leave a comment

Comments 29

prool April 25 2006, 20:09:04 UTC
В 1986-90 годах я работал в ХПВТИ (Харьковском предприятии ВТИ из системы главка ГКВТИ, см. Мемуары Пруля ;). Примерно в 87 или 88 мне пришлось возиться с операционной системой МОС (Мобильная операционная система), которая представляла упертый оттуда UNIX для ЕС Ряда 2 (то есть, для IBM System 370). МОС умела работать как на физической машине Ряда 2, так и на виртуальной машине под управлением СВМ (VM/360).

Так вот, в дистрибутиве МОС был, естественно, файл учетных записей /etc/passwd и в нем чуть ли не аккаунты Кернигана, Томсона и Ричи (создателей UNIX). Потом этот же файл /etc/passwd был приведен в какой-то переводной книге про UNIX издательства "Финансы и статистика" (такое ностальгическое издательство)

Reply

magenta_13 April 25 2006, 20:33:38 UTC
ПрилиШные книШки издавало, межпрочим... ;-)

Reply


Цитатку бы... old_greeb April 25 2006, 20:09:23 UTC
Из оригинала, да уж из перевода тогда. Очень хотелось бы видеть:)

Reply

Re: Цитатку бы... ex_timtaler707 April 25 2006, 20:23:58 UTC
+1!

Reply

Re: Цитатку бы... magenta_13 April 25 2006, 20:35:16 UTC
Агащаззз... Двадцать лет спустя... ;-)
Быть может, в Севастополе где-то в нычках и валяется, ежели матушка не навела им полный и окончательный порядок... ;-)

Reply

Re: Цитатку бы... old_greeb April 25 2006, 20:38:41 UTC
*С мольбой в голосе*: Ну приблизительно хоть... по памяти... реконструкцию...

Reply


yuriyk April 25 2006, 20:18:06 UTC
Какой ужас! И как голова это все выдержала? :)

Reply

magenta_13 April 25 2006, 20:36:54 UTC
А че ей сделается, голове-то? Голова тогда была молодая, коды асмовских команд в ОП держала... Это сейчас - одни байки... ;-)

Reply

yuriyk April 25 2006, 21:34:51 UTC
коды асмовских команд в голове? Так, я пошел... :))

Reply

magenta_13 April 26 2006, 05:15:18 UTC
Дык, сперва учителя таскали нас за шкварники как следует... На первом курсе предмет "введение в специальность", собственно, сошелся на двух вещах: алгоритмизация и асм. Ибиэмовский, естессно... ;-) Курс закончился написанием транслятора для одного их подмножеств пиэля: у каждой из четырех групп курса свое подмножество, группы разбиты на бригады во главе с БГП, проектирование сверху вниз с заданием базовой спецификации, написание параллельное, сборка по заглушкам. Просто взяли кувалду и оглоушили малышню, пока мозги свежие. ;-)
Это еще что... Среди прочих девайсов была у нас машинка "Саратов" - с ручным вводом команд и данных, тумблерами с пульта. На ней мы оттянулись, программируя в машкодах... И помнили же, оглашенные... ;-)
Это сейчас - 64К сплошного склероза. ;-)

Reply


x_vonamish April 25 2006, 20:53:05 UTC
LKED.SYSLMOD DD VOL=SER=SYSDA,DSN=...
Но я не о том. Случалось мне читать учебник по "Прологу". Там автор иногда резко менял тему на полуфразе и начинал рассказывать об уходе за цветами. Объяснял сопособы рассадки гладиолусов и прочее. На полстраницы. Потом говорил "Ну, мы отвлеклись" и возвращался оьратно к теме.
Вообще говоря, старая документация, как печатная, так и хранимая в наботах данных БОЛЬШИМИ БУКВАМИ, всегда блистала остроумием и изобиловала забавностями. Мда. Теперь уж такого нет.
Верите, нет, я теперь сам часто пишу техдокументацию. Без мата, хотя по-английски. Мне нравится это делать.
Иногда вставляю шуточки, как в старину. Но после редактуры их не остается. Не те времена.

Reply

magenta_13 April 25 2006, 21:12:11 UTC
Наш курс был жутко развращен в этом смысле - как Раддом-Праттом-Хоаром (в год нашего первокурсья был просто залповый выброс роскошных переводов), но и нашими замечательными лекторами во главе с Профессором-завкафедрой, читавшими остро и стильно.
Обломы начались на первых же курсовиках. Попытки излагать мысль в стиле любимых нами книжек пресекались на корню: "Что это за развязный американский стиль???" Когда мы брыкались и ныли: "Но вы свои лекции не уродуете!", нас обрывали просто и внятно: "А вы мою диссертацию почитайте."

Reply


egorfine April 25 2006, 22:11:37 UTC
Отилично! Я вот никогда в жизни не делал софтинку, в которую бы не заложил шалость словесную. Из того, что вспомнилось в первую очередь:

  • в системе для управления роликами в метро на первом же скрине для ввода логина-пароля выводится гигантский заголовок: Ты хто? - никто не замечал долгое время.
  • там же, вместо "список роликов" было написано "список кроликов" - аналогично
  • в кое-какой системе, которой в украине пользуются миллионы людей, на всех страничках ошибок заложил массу иронии. фишка в том, что в ней редко бывают ошибки:)
  • Нужно ли говорить, что теперь во всех системах в качестве приветствия стоит "превед"? пока тоже никто не обратил внимания.

Стараюсь также предусмотреть вариант введения логически несовместимых параметров, и в этом случае выдавать не скучную ошибку, а какую-то колкость. :)

Long live easter eggs ;)

Reply

x_vonamish April 26 2006, 00:27:22 UTC
При написании одной доки требовалось показать читателю образец заполнения некой электронной таблицы, вид интерфейса. Ну и там прописано имя, фамилия, адрес, телефон... стандартная строчка из какой-то базы данных. В одну из строчек я вписал Саддама Хуссейна.
Ну и потиаю руки, значит.
Фигушки! Когда открыл "живую" бумажную книжку, там значился Джон Смит или типа того.

Reply

magenta_13 April 26 2006, 05:44:25 UTC
Еще хорошо, что не Джон Доу. ;-)
Политкорректность, дааа? ;-))

Reply

magenta_13 April 26 2006, 05:21:04 UTC
А ведь не так обидно получить шутку в качестве сообщения об ошибке... при условии, конечно, что дальше разъясняется, куда пойти и что делать. ;-)

Reply


Leave a comment

Up