Почему нужно читать техническую документацию, или — 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!: 1 комментарий

  1. Алексей

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

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

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

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