Почему нужно читать техническую документацию, или — RTFM!

Всем привет!

Сразу небольшой дисклеймер:

Данная статья содержит элементы пафоса и снобизма, особо холливарным личностям просьба пропустить этот пост :)) Все нижесказанное (как все содержимое данного блога) — абсолютное ИМХО! Просьба не воспринимать данную информацию в свой адрес, это лишь мнение одного человека :)

Довольно часто в комментах или в почте меня просят посоветовать литературу по какой-либо технической теме и данный вопрос вводит меня в ступор. Я вроде бы и хочу помочь но не знаю что ответить, а тупо отправить человека в гугл или в —help не позволяет совесть т.к. сам таким был :)

Кст, кто не в курсе, у айтишников (особенно за бугром) распространена аббревиатура RTFMRead The Fucking Fulll (Fine) Manual :) что есть чем-то похожим на традиционное «погугли» или «ф поезг»  и т.п. То есть, если вам сказали RTFM — можете начинать обижаться :)))

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

В этом нет ничего постыдного и я всегда стараюсь помочь в таких ситуациях, но что-то я начинаю уходить от темы :)

Так почему же все-таки нужно читать мануалы (официальную документацию от производителя ПО)?

По списку:

1. Оф. документация практически всегда (бывают исключения) содержит наиболее полную информацию о программных продуктах, или железе.

2. Кроме того, информация из оф. источников наиболее правдивая и на нее можно с уверенностью сослаться в случае, если что-то пошло не так. Этот пункт ОСОБЕННО важен при работе с продуктами так называемых А-брендов (Cisco, IBM, HP, VMware и т.п.).

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

4. Адекватный и правильный ответ в официальной документации можно найти гораздо быстрее, чем читая тонну форумов и блогов, комментарии к ним, а потом выбирать проверять каждый вариант на работоспособность.

Это первое и самое важное, что приходит на ум.

Не все со мной согласятся, я знаю…и опять же — бывают исключения :)

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

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

И сейчас  я всегда пафосно заявляю «Лучшая литература по продукту — официальная документация. Все остальное — художественное чтиво.»

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

НО! Лично я, категорически не рекомендую воспринимать любые статьи (в том числе и мои) в блогах и форумах как руководство к действию и строго по ним настраивать что-то, особенно если это «что-то» будет использоваться в продуктиве. Советую рассматривать данную информацию просто как пример настройки, что бы на этом примере разобраться в архитектуре и устройстве того или иного продукта, особенно, если продукт хорошо документирован.

Потому что потом начинается: «А я все сделал как написано в статье и у меня не работает! Статья — говно!» все потому, что кто-то бездумно скопировал конфиг и даже не потрудился разобраться что эти все параметры значат и подставить свои значения.

Но все же решать вам, это просто совет.

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

Все тоже самое касается и технических книг на айтишную тематику в стиле «Windows 2008 для профессионалов» или «Администрирование FreeBSD 5 для чайников».

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

Сейчас у меня осталась одна техническая книга, которая мне дорога как память, т.к. с нее началось мое увлечение Linux (да, я безумно сентиментальный:))). Называется она «Linux для пользователя» редакции 2003 года и на сегодняшний день содержит ноль целых хрен десятых актуальной информации. А ведь прошло каких-то 10 лет… В свое время (в 2006 году, если не ошибаюсь), я прочитал ее от корки до корки и глубоко проникся идеологией Linux, хотя даже тогда она уже была не самой актуальной.

Все остальные книги я раздарил всяким маньякам-книголюбам т.к.  мне вряд ли понадобится книжка «Администрирование Windows 2000» или «Fedora Core 5» (и т.п.) и лежит она мертвым грузом пыль собирает, а выбросить жалко…

Конечно, есть и в IT сфере вечные книги, в основном по технологиям бородатого года, которые еще долго будут актуальными (например DNS), но я совершенно не понимаю маньяков, которые покупая все на своем пути, тратят сумасшедшие деньги на книги по продуктам, которые устареют быстрее, чем эта книга будет прочитана.

Бывают исключения, я не спорю, но нет такой волшебной книжки, которую вы прочитали и сразу стали гуру — неа, чудес не бывает! Нужно перелопатить горы информации и набить много шишек на практике…

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

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

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

Напоследок немного ссылок на оф. документацию по продуктам:

VMware vSphere 5.1http://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html

Debianhttp://www.debian.org/doc/

Ubuntuhttps://help.ubuntu.com/

Nginx http://nginx.org/ru/docs/

Apachehttp://httpd.apache.org/docs/

Windows Server 2008 (R2)http://technet.microsoft.com/library/dd349801

Active Directory Group Policyhttp://technet.microsoft.com/ru-RU/windowsserver/grouppolicy/default.aspx

ну и конечно же: man и —help

Комментарии, замечания и критика (не очень жесткая) приветствуются ;)

Всем добра! :)

Почему нужно читать техническую документацию, или — RTFM!: 5 комментариев

  1. Алексей

    Вся официальная литература безусловно должна быть прочитана, это как «Отче наш…». Но я склоняюсь более в поддержку русифированных источников официальной документации, т.к. эти сообщества по сути ее дополняют + вполне вероятно найти уже готовые решения на стандартные вопросы :)

  2. g many

    Hello there, just became alert to your blog through Google,
    and found that it is truly informative. I’m gonna watch out for brussels.
    I’ll be grateful if you continue this in future.
    Lots of people will be benefited from your writing.
    Cheers!

  3. those g

    Greetings from Carolina! I’m bored to death at work
    so I decided to check out your blog on my iphone
    during lunch break. I enjoy the information you provide here and can’t wait to take a look
    when I get home. I’m shocked at how quick your blog loaded on my phone
    .. I’m not even using WIFI, just 3G .. Anyhow, awesome blog!

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

Не робот ли ты часом? * Лимит времени истёк. Пожалуйста, перезагрузите CAPTCHA.