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

Коллеги! Пишет вам всё тот же эникейщик, у которого 20-килограммовый рюкзак стал лишним в процессе эволюции. Прошу не обижаться за резкость, а выслушать и понять.

Вот этого юношу в армии дёргали по всяким там вопросам — от пресловутого набора текста до восстановления загрузочных секторов на жёстких дисках и спасения удалённых документов. И был там финотдел, который платил юноше зарплату. Совершенно незаслуженную, хотя и документированную, надо сказать. А всё почему?

Есть там где-то какая-то таблица, в которой этот юноша совершенно не разобрался. Чей косяк, спросите вы? А я вам отвечу: конечно, этого юноши, который, возомнив себя джедаем, начал победоносную миссию по изменению непонятного ему, но простого по сути процесса в жёлтой программе.

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

Уважаемые мои коллеги (хоть я давно уже и не эникейщик по сути), скажите мне, пожалуйста, до каких пор мы будем терпеть в своей среде подобных товарищей, которые с большим трудом выучили установку ZverDVD (и на которых потом совершенно справедливо жалуются умные люди)? Наш герой жалуется на 20 тысяч наименований в таблице — а что будет, когда он вернётся на гражданскую службу, устроится сисадмином в какую-то компанию, где наименований будет не 20 тысяч, а все 200? Он тоже применит свою любимую программку? А когда генеральный директор с него спросит, почему результаты именно такие, а не те, что должны быть, он опять с большим удовольствием сошлётся на Васю Пупкина, писавшего эту программу? А результат-то какой?

Ему жалко потратить шесть часов личного времени на восстановление правильной работы программы по тем канонам, которые в неё заложили разработчики. Пусть так, но ведь 1С — это не программа Васи Пупкина из Нью-Васюков, она проверена и работает годами во многих компаниях. Пусть не совсем так, как хотят конечные пользователи, пусть с некоторыми ошибками — но всё равно лучше и стабильнее, чем эти вот «программки», которыми пользуется автор. И как его после этого назвать, кроме как «эникейщиком» в самом плохом смысле этого слова? Человек даже не даёт себе никакого труда разобраться, какую именно программу он применяет, как она работает, что будет в итоге, а потом требует зарплату, настаивает на правильности результатов работы и просто уверен в собственной непогрешимости. И это несмотря на тот факт, что он использовал чужую программу с непредсказуемым уровнем качества работы. Мои аплодисменты… сквозь слёзы.

Зато он успел сходить в спортзал, помыться и побриться — безусловно, это куда важнее, чем выдача пользователям однозначно проверенного и работоспособного решения. Пускай в этот раз всё получилось, а в следующем цикле вычислений всё встанет на уши. Ну и что, зато сисадмин побрит, накачан и подтянут. А что ещё надо компании?

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

Лет восемь работал в «почти IT» — от системного аналитика до руководителя департамента. Потом меня призвала любимая с детства звукорежиссура, и вот уже второй год для компьютеров я всего лишь «обычный юзверь», даже SQL-запрос с первого раза грамотно не напишу.

31 декабря девушка попросила купить на каникулы радиоуправляемую летающую рыбу, чтобы проводить время со смыслом. За несколько часов до поздравления президента найти оперативный интернет-магазин не получилось, пришлось ехать в сувенирный. Там милые приветливые девушки за 10 минут до закрытия (19:50) сняли с витрины последний экземпляр и сразу же предложили «за каких-нибудь 600 рублей» надуть гелием, чтобы я два раза не бегал. Пока с одной девушкой мы проводили оплату по карте, другая занималась надувательством. Рыбка гелия не выдержала и лопнула.

20:00, магазин закрывается, надо вернуть деньги, платил я банковской картой. Улыбка на лице кассирши пропадает моментально: оказывается, она не знает, что делать. Звонит кому-то куда-то, там нетрезвый голос рассказывает по сбивающимся шагам, как сделать возврат средств на терминале. За эти быстрые десять минут я с телефона нахожу не только инструкцию и разницу между отменой транзакции и возвратом, но и настойчиво пытаюсь объяснить, что коль скоро кассу не снимали, то надо делать отмену, ибо возврат пройдёт отдельным банковским переводом за два рабочих дня, что с учётом праздников значит «зажать деньги на десять дней», а в новогодние праздники они могут нечаянно оказаться нужными.

После минутного сопоставления её «мне видней» и моего «если будет возврат, я подам жалобу лично на вас работодателю и на фирму — в суд» продавщица психанула, выдала мне сумму наличкой и выставила за дверь.

ИП и мелкие торговцы, потрудитесь хотя бы оставлять распечатку на полстраницы для кассиров, которые не умеют пользоваться торговым терминалом. Вам же выгоднее выйдет…

Ходил чинить компьютер к юзверю на дом.Подхожу к домофону в стандартной пятиэтажке и виду следующие надписи на панели домофона:

— Введите номер квартиры
— Дождитесь ответа
— В случае ошибки набора номера нажмите DEL
— Для ввода кода открытия двери нажмите CODE

А на цифровой клавиатуре домофона был полный набор цифр от 0 до 9 и всего лишь две функциональные клавиши: [C] и [0--╝] (ключ).

Что значит [C]? Code? Clear? Call? А что значит [0--╝]? Ввод ключа?

Так и живём: пишем в мануале одно, а на деле имеем другое.

Сотрудница, далеко не блондинка, уложила под стул вопросом:

— Слушай, а как в такую маленькую флешку помещается целых четыре гигабайта? Гигабайт же огромный, размером примерно с лист А4!

Когда дошло, сдержать смех не смог при всём желании.

Если б вы только знали, как выматывает меня возня с продуктами жизнедеятельности индусских программистов! Сплошные косяки, подчас глупые, подчас такие мелочные, но отнимающие часы и даже дни чужого рабочего времени. Нет, знаки препинания и грамматика тут ни при чём. Конечно, текст мануала должен быть написан грамотно, но я не претендую на звание граммар-наци. Меня парят косяки другого плана.

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

У программистов всё проще. Любая ошибка может быть исправлена. По телефону, с помощью форумного трёпа, методом вызова «специалиста», но исправлена. А жжёные транзисторы, увы, не исправить. Сгоревшие деньги, увы, не вернуть. Но если сгоревший на отладке силовой модуль выбрасывается и ставится новый, то с косяками индусских программистов приходится устраивать танцы с бубном.

* * *

Вводим новую офисную АТС. Требуется настройка доступа абонентов на межгород. В официальном мануале написано: по умолчанию установлен первый класс доступа, то есть все могут звонить, куда хотят. В этом же мануале, только в алфавитном указателе в конце, русским по белому написано: по умолчанию класс доступа седьмой, то бишь возможны только внутренние вызовы. На деле же абоненты могут звонить только по внутренним телефонам и по городу, но не на межгород. То есть текущее значение класса доступа — и не 1, и не 7. А что?

До клиента полторы сотни километров. По телефону пытаюсь выполнить настройку АТС. Так шиш! В процессе ввода команды надо нажать клавишу Flex1. Я проглядел каждую страницу мануала к системному телефону, облазил весь интернет в поиске картинок этого аппарата — нет клавиши Flex! Клиент её тоже найти не может, у него-то системный телефон перед глазами.

Оказывается, клавиши Flex — это маленькие кнопочки быстрого вызова. Только надписи Flex рядом с ними так и нет. Класс доступа вводился не одной, а двумя цифрами, чего не было указано в мануале. А в настройках АТС был установлен класс доступа 2. То есть 02.

Перевели одну компанию на «тонкие клиенты», подняли виндовый терминальный сервер (не брендовый, но собранный из качественных десктопных комплектующих), закупили несколько «тонких» — всё работает, люди рады.

А теперь эпик-фейл: на большинстве рабочих мест используются машинки Core i5, 4 GB RAM, 500 GB HDD, Linux Mint, единственной задачей которых является поднятие в автоматическом режиме сессии RDP. Я не хочу жить в таком мире.

Форумы хороши, когда надо решить небольшую конкретную задачу, но для полноценного погружения в тему лучше бумажной книги пока ничего не придумали.

Я уже давно хотел конкретно проникнуться линуксом и даже попробовал несколько дистрибутивов, но из-за нашей вездесущей Windows-жизни погрузиться в него с головой не смог. Купил наконец-то «Библию Ubuntu», естественно, сразу ушёл в изучение. Не прошло и десяти минут, как я заляпал страницы жиром от колбасы. Отругав себя за порчу новой книги, подумал: сейчас точно залью книгу кофе, останется только случайно прожечь её сигаретой, а был бы у меня кот... ну, сами догадаетесь. Всё-таки компьютерщик — это диагноз.

Принесли мне как то флешку со словами: «Там в тексте иероглифы, надо сделать так, чтобы прочитать можно было». Я сразу подумал, что речь идёт о каком-нибудь текстовике в KOI8-R, стянутом со старого диска с рефератами, и будет нужно лишь сменить кодировку на знакомую «блокнотику».

Вдоволь напившись чая, решил выполнить поручение. На флешке оказался PDF-файл, что насторожило. Открываю и вижу инструкцию для неопознанного USB-девайса на китайском!

Понадобилась мне как-то раз инструкция по программированию древней мини-АТС 2х8. Куча буквенно-цифровых кодов — вспомнить нереально.

Первым делом отправляюсь на Яндекс, ввожу запрос и так, и эдак. Перечитал все выданные страницы от первой до последней корки — изредка лишь попадаются упоминания о той АТС, об инструкциях и говорить нечего. Пробую Рамблер — то же самое, уже прочитанные ссылки и давно умершие сайты. Становится совсем грустно: похоже, производитель всю документацию удалил, а конторы, которая делала перевод, уже и в живых нет.

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

Вылезает одна- единственная страница результатов с несколькими ссылками. Щёлкаю первую, вторую — «страница не найдена». Возвращаюсь на страницу поиска. Блин, а знакомый адрес! Приглядываюсь: ё-моё, это ж мой собственный сайт, эти файлы я сам когда-то «расшаривал» для коллег! Захожу на соседний комп и нахожу потерянное руководство.

На сайт файл я опять выложил — мало ли, опять потеряю или ещё кому понадобится.

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

— Эй, чувак, есть мелочь? Ты чё такой волосатый? Ты чё, ботан?

Гляжу — придурок полез в карман. Скорее всего, у него там выкидной нож, а у меня в руках только пакет со справочником сисадмина по Windows Server 2003. Правда, том увесистый — весом в два кило и толщиной в полторы тысячи страниц.

Не желая дожидаться демонстрации колюще-режущих предметов, я размахиваюсь пакетом, намереваясь съездить гаду по шее. Пакет не выдерживает, и два килограмма информации улетают в направлении головы гопника.

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

Да, гопник остался жив, а книжка отделалась легким испугом — после протирки спиртовой салфеткой была как новая!

Заглянул на днях в серверную, а там сидит админ, ничего не делает — и тишина. «Благорастворение на воздусях и во человецех благоволение.» Звезда, естественно, в шоке: если в серверной тихо, значит, ничего не работает. Если ничего не работает, почему админ такой довольный? (И, кстати, как может ничего не работать, если я пять минут назад договорился с ним по аське, что сейчас приду в серверную?)

...в недрах машины разогнался кулер, чего-то там охладил и затих. До меня допёрло, что всё в серверной работает, но намного тише, чем обычно. Хозяин серверной рассказал вот что: так ему надоело сидеть в постоянном гуле, что он специально ночью задержался на работе, ненадолго отключил сервер (если положить и поднять аккуратно, не страшно — фирма у нас небольшая), чего-то там почистил, смазал, переставил, поставил новую систему охлаждения и вот теперь ему — хорошо.

Откуда новая система охлаждения? Начальство денег дало.

Как дало? Добровольно и с песней.

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

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

Товарищ! Помни: продуманная сопроводительная документация — залог успеха любого проекта.

Дело было в 2004-м, тогда запускали склад для %bigcompanyname%. Компания эта, помимо всего прочего, производит и автомобильные запчасти. А поскольку запчасти некоторые импортные, они обязательно должны были пройти процесс русификации, т.е. на коробочке должна быть этикетка с информацией по-русски.

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

В общем, спроектировали, разработали, установили. Все работало хорошо, все довольны. Но однажды случилось следующее: кто-то из операторов склада в запарке забил в информационное поле "хрень какая-то". В ответ производитель прислал уточнение: "35 мм". Итак, время не стоит на месте, на всю партию продукции печатается длинная лента этикеток с указанием "Хрень какая-то. 35мм". Заметили только те, кому надо было обклеивать продукцию.

Висит у нас возле УАТС инструкция, солидная такая, пунктов 12-15, на случай зависания одного транка.

Что-то вроде такой:
1. Отключить пользователей транка %name%
2. Проверить связь до городской подстанции
и т.д.

Но самое главное, после всех жутко важных и обязательных пунктов стоит приписка - "или просто выключить питание на 10 секунд".

Случилось это на заре моей карьеры в саппорте банк-клиента.

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

Позвонил как-то раз мне один занятный дядечка, примерно 50-ти лет. Говорит, читал инструкцию, но не выходит у него "каменный цветок" никак. Не переходит по ссылке и всё! И никакой ошибки при этом. Я час угробила, чтобы понять, что же все-таки поисходит.
В итоге выяснилось, что дядечка для удобства чтения распечатал руководство. И, позвонив мне, действовал в точности согласно моим указаниям!
Т.е.: положил на стол распечатанный html, положил на ссылку мышку и кликал по ней! Оказывается, дядечка даже комп выключил "чтоб не мешал"...

Пришел сегодня в ресторан и поднялся в комнату администрации. Ну по работе я пришел, с директором поговорить. Захожу и тихо выпадаю в осадок. Вижу следующую картину:

В углу стоит, видимо, серверный шкаф. одна створа открыта, видна гора оборудования. Но радует меня лист А4 на второй дверце.

"Уважаемые дамы, убедительная просьба, в случае отключения питания выключите все оборудование из сети. В случае грозы отключите провода от серенькой коробочки с надписью D-Link. Елена, во всех остальных случаях, НЕ ПОДХОДИТЕ СЮДА. С уважением, Леша."

Я - тестер, правлю руководство пользователя после технического писателя.

Окончательно встаю на фразе "После задания всех требуемых параметров, нажмите кнопку "сохранить", чтобы запомнить совершенные изменения"

Не сдержалась.

Исправила на "сохранить совершенные изменения" и вставила примечание: "Нажатие на кнопку "запомнить пароль" не поможет вам запомнить пароль"