Notice: Function _load_textdomain_just_in_time was called incorrectly. Translation loading for the wptelegram domain was triggered too early. This is usually an indicator for some code in the plugin or theme running too early. Translations should be loaded at the init action or later. Please see Debugging in WordPress for more information. (This message was added in version 6.7.0.) in /home/u632055791/domains/itg.az/public_html/wp-includes/functions.php on line 6114

Notice: Function _load_textdomain_just_in_time was called incorrectly. Translation loading for the wp-pagenavi domain was triggered too early. This is usually an indicator for some code in the plugin or theme running too early. Translations should be loaded at the init action or later. Please see Debugging in WordPress for more information. (This message was added in version 6.7.0.) in /home/u632055791/domains/itg.az/public_html/wp-includes/functions.php on line 6114

Notice: Функция _load_textdomain_just_in_time вызвана неправильно. Загрузка перевода для домена kirki была запущена слишком рано. Обычно это индикатор того, что какой-то код в плагине или теме запускается слишком рано. Переводы должны загружаться при выполнении действия init или позже. Дополнительную информацию можно найти на странице «Отладка в WordPress». (Это сообщение было добавлено в версии 6.7.0.) in /home/u632055791/domains/itg.az/public_html/wp-includes/functions.php on line 6114
Почему нужно читать техническую документацию, или — RTFM!

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

Всем привет!

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

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

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

Кст, кто не в курсе, у айтишников (особенно за бугром) распространена аббревиатураRTFM — Read 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.1 — http://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html

Debian — http://www.debian.org/doc/

Ubuntu — https://help.ubuntu.com/

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

Apache — http://httpd.apache.org/docs/

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

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

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

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

Всем добра! 🙂