Про язык документации к IT-устройствам: papa_gen

Про язык документации к IT-устройствам

Купил для конторы новое сетевое оборудование и к нему чудо-точку wi-fi доступа невероятной силищи, что пробивает, подобно отбойному молотку, стены толщины неимоверной. Т.е. чтобы можно было бродить и этим самым вайфаем пользоваться. Удобно же.

Купили, поставили. А потом стали эту точку настраивать. Угу. С понедельника. Три вумных человека над нею пыхтели. Никак. Звонил в контору, где купил. Там всякие гении из числа "сертифицированных инженеров" давали инструкции и выкладывали на нее дукаменты. Короче, никак. Несколько раз так донастраивались, что приходилось перезагружать до заводских настроек.

Наконец, сертифицированный умник предложил ей перепрошить ПО. Отчего же и не перепрошить? Только решил поискать в сети сам. Таки нашел один форум сетевых специалистов Германии и в нем маленькую веточку про эту чудо-точку.

Человек как раз наш вопрос задает. А другой ему ответил. Так вот. Суть ответа в том, что в документации и прошивке отчего-то точка доступа названа в режиме работы по умолчанию не точкой доступа, а ретранслятором. Нужно просто и тупо поменять IP-адрес у этой точки доступа, ввести имя сети и пароль. И все. Больше ничего делать не нужно.

Сама процедура настройки заняла ровно три минуты.

А ребята три ночи не спали, репу чесали. Даже перепрошивать устройство хотели. А делов всего ничего. Но в документации про это ни слова, зато где-то 80 страниц посвящено "тонкой" настройке, которая никому нафиг не нужна.

Это чем там составители документации думают, каким-таким местом? За такое надо долго и упорно бить по мордасам.

Работает она, кстати, превосходно. Хожу и радуюсь. На триста метров отошел от лесопилки, а вайфай только полсигнала потерял. Куплю себе такую же для дома, благо таперича ведаю, как ее самому настроить

MaxF1312

November 21 2013, 12:52:55 UTC 5 years ago Edited: November 21 2013, 12:53:04 UTC

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

papa_gen

November 21 2013, 12:56:51 UTC 5 years ago

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

deka

November 21 2013, 18:59:44 UTC 5 years ago

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

November 21 2013, 19:03:58 UTC 5 years ago

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

klein_zaches

November 21 2013, 13:49:20 UTC 5 years ago

а что за модель, можно полюбопытствовать? Не Cisco часом? А то бы тоже такую домой установил, если бюджетная цена.

November 21 2013, 13:55:43 UTC 5 years ago

Циска.

aptukkaev

November 21 2013, 14:10:14 UTC 5 years ago Edited: November 21 2013, 14:11:43 UTC

Доброго Вам для!
Ну что же, право слово, ополчились супротив главного тезиса рынка 21 века — клиент не должен забывать дорогу в магазин.
И продукция киски-циски завсегда усю правду-матку в середине инструкции или ближе к концу пишет.
Проверено с 1991 году — я сразу читать лезу в серёдку, в раздел тонкой настройки.
Она грубей всего завсегда бывает, а не тоньшей.

Надо бы Вам об этом притчу написать для юношества поучительную :-).

Сам свой многоканальный телефон за пару минут настроил, хотя спецы мои умудрились с супружнице выдурить аж 12 тыров в 1199 году.
За что их нещадно рублём наказал премиальным и показал, что читать уметь надо.

Эх, папа Ген — мы с Вами последние читать обучены.
Потому что знаем правило — если ни хрена не получается, открой наконец инструкцию и прочитай её в туалете. Всё одно там больше заняться нечем :-).

ole4ka_22

November 21 2013, 14:29:16 UTC 5 years ago

Теперича за грибами будете с вай-фём ходить и миру в три раза зависти вызывать ихними фотками )))))

November 21 2013, 18:57:40 UTC 5 years ago

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

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

PS. Кстати, это тоже аргумент в пользу того, что руководитель из числа "лучших профи" -- очень не лучшее решение.

November 21 2013, 19:01:13 UTC 5 years ago

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

November 21 2013, 19:09:30 UTC 5 years ago Edited: November 21 2013, 19:13:41 UTC

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

PS. Это я говорю, как человек, почти постоянно за последние лет 25 тесно связанный с разработкой ПО -- и как исполнитель, в частности.

Про язык документации к IT-устройствам

Select pictures (pictures will be 640 pixels wide)