Истории с тегом: документация

Всего историй: 16

719

Благорастворение на воздусях и во документации начальственное благоволение

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

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

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

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

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

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

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

449

Как тонко подмечена суть

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

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

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

341

Проверено: работает!

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

Что-то вроде такой:

1. Отключить пользователей транка %name%

2. Проверить связь до городской подстанции

и т.д.

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

247

А чего он тут энергию потребляет?

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

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

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

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

Т.е.: положил на стол распечатанный html, положил на ссылку мышку и кликал по ней! Оказывается, дядечка даже комп выключил "чтоб не мешал"...

126

Не влезай, убью!

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

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

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

53

А если не нажмете - забудете.

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

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

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

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