Как правильно читать мануал

Введение

Многие начинающие программисты (не зависимо от изучаемого ими языка программирования) считают, что «профи» не читают мануал (или читают его крайне редко), потому что знают все наизусть. Это заблуждение. Без сомнения, люди с опытом помнят из мануала больше, чем начинающие. Но это не основной плюс, который приходит с опытом. Запомнить все не возможно, и мануал имеет свойство обновляться вместе с тем, что он описывает – какой толк с того, что этот «профи» помнит устаревшую информацию?

Умение искать информацию – гораздо важнее самой информации.

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

Как читать мануал?

Мануал читают тремя способами:

1. Если Вы хотите знать больше, чем знете сейчас. Независимо от того, знаете ли Вы много, знаете очень мало или ничего не знаете. Особенно полезен, если Вы еще ничего не знаете или знаете очень мало. Читайте мануал так, как если бы Вы читали какую-нибудь сказку. Просто ходите по страницам мануала и читайте все, что еще не читали раньше. Выделите 5% своего рабочего времени на такое чтение – это время Вам потом с лихвой окупится.

2. Если Вы решаете какую-то задачу и для ее решения нужно использовать какую-то функцию, но Вы не знаете какую. Или Вы знаете, какую функцию можно было бы использовать, но Вам кажется (или, может, так оно и есть), что эта функция – не совсем то, что Вам нужно. Найдите эту функцию (если не знаете, где ее описание, то воспользуйтесь способом, описанным ниже). И прочитайте все, что касается этой функции, в том числе ссылки в разделе «смотрите также» и комментарии пользователей. Если найденная функция не совсем Вам подходит, то, возможно, ссылка на искомую функцию содержится в «смотрите также». В комментариях пользователей содержится много полезной информации, особенно по всяким нестандартным задачам. Как говорил один из моих шефов: «если перед Вами возникла какая-то задача, то не сомневайтесь – до Вас ее как минимум человек десять уже решали – просто найдите решение». Для такого чтения много времени не требуется и, следовательно, планировать его тоже не нужно.

3. Вы знаете, какая функция нужна для решения Вашей задачи, но забыли ее имя и/или перечень/назначение аргументов или какую-нибудь особенность ее работы. В этом случае о чтении речь как бы и нет: вы просто «подсмотрели» какую-нибудь мелкую деталь. Это самый простой вариант и, думаю, он не нуждается в комментарии.

Многие начинающие программисты убеждены, что даже если опытный программист и читает мануал, то только третим способом (потому что забыл какую-нибудь мелкую деталь). Это заблуждение. Даже очень опытные программисты читают мануал всеми тремя способами.

ПОМОГИТЕ! Не могу там ничего найти!

Итак, у вас появилась проблема.

При этом Вы, честно говоря, ни черта в этом не понимаете и даже не подозреваете, с какой стороны подойти. Я не буду спрашивать вас, зачем тогда вы этим занимаетесь. Бывает. Итак, возьмем как пример PHP Manual – отличный пример хорошо структурированного и почти идеального мана. Откроем его. И что мы видим? Нет, можете не обращать внимания на имена-фамилии составителей (хотя не мешало бы и их запомнить). Я про то, что находится ниже и называется Table of Contents .

Надеюсь, что вы себе представляете, что это. По-русски это звучит как «содержание». Теперь наступает время тяжелых размышлений: что нам, собственно, надо в мануале? И действительно, что мы там забыли? Возьмите свою проблему и подумайте, какие области из перечисленных в Table of Contents она затрагивает и какие области может затронуть решение.

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

Если подумать, то становится ясно, что: вывод каким-то образом связан с текстом, точнее со строками, еще точнее – со String functions. Если мы выводим что-то из базы, то надо искать в разделе, который ей посвящен (если у вас My SQL, то вам в MySQL Functions); проблема явно связана с математикой (арифметикой) – нам надо ДЕЛИТЬ общее количество на страницы.

Таким образом, шаг за шагом, мы приходим к функциям echo(), mysql_query(), mysql_fetch_*() (мы прочли ман и поняли, что mysql_result() не стоит использовать), мы посмотрели в Mathematical Functions и нашли там функцию ceil(), а также (по аналогии с многими языками и по подсмотренным в мане примерам) нашли конструкцию while(). Что нам еще надо? Ничего. Нам УЖЕ ничего не надо. Мануал – под рукой, пишем скрипт.

Что-то не работает – смотрим, почему, выводим переменные (print_r() нам поможет в этом), проверяем синтаксис функций и правильность нашего выбора. Вы спросите: «А где же тут форум? На каком этапе он появляется и зачем он вообще нужен?». А форум появляется только тогда, когда вы будете испытывать сложность в АЛГОРИТМЕ или сомневаться в оптимальности вашего алгоритма. Что же делать, если вы вообще себе алгоритм не представляете? Тут масса вариантов: бросьте, это не ваше; доучитесь, а потом беритесь; купите себе книжку, попробуйте почитать все сначала; прочтите, наконец, мануал. Запомните одно: в мануале есть МАССА ПРИМЕРОВ. Вам всего-то надо уметь искать и читать (надеюсь, что copy/paste вы сделать сможете?).

Ну вот вы чего-то не нашли в мануале (скорее всего плохо искали). И что делать? Да ничего. Сесть, успокоиться, открыть свой любимый поисковик и набрать ключевую фразу: «Как сделать так, как я хочу?». Уверяю вас – там будет масса попаданий.

Нет? Тогда открываем форум, жмем на ссылочку «ПОИСК В ФОРУМЕ" и пишем туда ключевые слова. Обратите внимание, что на форуме PHP-клуба при поиске находятся только те топики, в которых есть слова ровно в той форме, как Вы задали в строке поиске. Например, если Вы будете искать фразу типа «как хранить деревья», то в качестве результата появятся топики, в которых есть слово «как», слово «хранить» и слово «деревья». Если в форуме есть топик, в котором есть слова «как» и «хранить» и «дерево», но нет слова «деревья», то этот топик в результат не войдет. Пробуйте разные словоформы. Если есть топик, в котором есть слова «хранить» и «деревья», но нет слова «как», то этот топик тоже не будет показан в результате. Но ведь слово «как» Вас не интересует, не так ли?. Используйте только самые важные слова. Чтобы искать по части слова используйте звездочку: поиск по «дерев*" найдет все топики, в которых есть слова, начинающиеся на «дерев»: «дерево», «деревья», «деревянный», но не «древообразный».

Не нашли? Ну что ж, пишите в форум.

Внимание!

Перед тем, как писать в форум, обязательно прочтите правила форума и сделайте еще одну очень важную вещь – задайте себе тот вопрос, который вы хотите задать в форуме. 49% людей не могут толком задать вопрос, еще 49% могут ответить на него сами, но почему-то этого не делают, остальные 2 процента – это реальные вопросы. В последнее время эти 2 процента все чаще превращаются в вопросы типа «Я не умею читать, покажите мне строку, в которой написано «мама мыла раму»! Плииииз!»

Не стоит к ним присоединяться. Лучше пойдите, попейте кофе/чай/пиво/водку и подумайте. Если вы ПРАВИЛЬНО прочли ман, то ответ ДОЛЖЕН к вам прийти, надо только чуть-чуть подумать. Когда будете бить себя по лбу и кричать «Как же я сразу не догадался?!", не забудьте поставить на стол чашку/кружку/рюмку.

Часто задаваемые вопросы

Я знаю имя функции, но никак не могу найти ее описание.

Скачайте документацию в формате “Windows HTML Help” (*.chm):
http://www.php.net/download-docs.php
Запустите ее, на вкладке «Указатель» наберите имя функции и нажмите Enter.

Описание функции также можно найти, набрав в браузере:
php.net/имя_функции
Например,
http://php.net/mysql_fetch_assoc

Что делать, если я не умею искать?

Шаг 1. Искать так, как если бы Вы умели искать. Забудьте слово «не умею».

Шаг 2. Выполнится автоматически после того, как Вы много раз проделаете шаг 1. Умение придет с опытом.

Я часто что-нибудь ищу, но так и не научился толком искать. Почему?

Есть такая пословица: без труда не выловишь и рыбку из пруда.

Несмотря на эту пословицу, многие хотят без труда выловить рыбку из пруда.

Вон, даже в «Матрице» обучение идет по ускоренной программе: вставили дискетку, пять секунд и Вы уже умеете управлять вертолетом. Идея о таком способе обучения не на пустом месте возникла – она взята из жизни. Не забывайте о том, что в реальной жизни такого не бывает!

Если Вы еще не научились – учитесь дальше!

Что делать, если я не умею пользоваться расширенными возможностями поиска?

Нужно прочитать документацию по расширенным возможностям поиска – там все написано.

Что делать, если я не знаю, где описаны расширенные возможности поиска?

Нужно найти то место, где описаны расширенные возможности поиска. Поиском для этого, кстати, пользоваться не требуется – просто посмотрите внимательно на страницу с формой для поиска, где-нибудь должна быть ссылка.

Я ищу-ищу, но ничего не могу найти. Что делать?

Искать дальше. Попробуйте другие способы, другие ключевые слова, другие поисковые системы. Кстати, на форуме РНР-клуба можно искать не только при помощи формы поиска, которая есть на самом форуме, но и при помощи Яндекса и при помощи Google! Искать можно не только на форумах PHP-клуба, но и на других сайтах.

Находка, выдумка, смекалка Вам помогут.

Читать мануал как сказку? Разве такое возможно – ведь сказка – это интересно, а мануал – это так скучно!

Вы можете представить себе профессионального врача, у которого любимое увлечение – игра в футбол, а медициной он занимается только по принуждению? Представьте, что этот врач будет делать Вам операцию. Что Вы чувствуете?

Если Вы считаете, что читать мануал – это скучно, то откажитесь от программирования вообще.

Если Вы не можете отказаться от программирования, то представьте себе, что мануал – это очень интересно для Вас. Откажитесь от мысли, что мануал – это скучно и исходите из соображения, что мануал – это интересно.

Вы сравниваете нас с начинающими программистами. Вы хотите нам доказать, что мы ничего не умеем?

Я сравниваю не Вас, а начинающих программистов с опытными. Если Вы приписали себя к начинающим, а не к опытным, то Вы сделали это самостоятельно.

Я привожу сравнения для того, чтобы Вам было проще смотреть на все с точки зрения опытного программиста, даже если Вы сами себя таковым еще не ощущаете. Припишите себя к опытным и смотрите с точки зрения опытного программиста. Забудьте о своей неопытности и ощущение опыта со временем придет к Вам.

Нет ничего плохого в том, если Вы только начинаете, еще ничего не знаете и не умеете. Плохо, если Вы не хотите знать и не хотите уметь.

Всё ясно! Чтобы стать профи, нужно читать мануал!

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

Почему некоторым не нравится фраза: «ПОМОГИТЕ! Не могу там ничего найти!»

Потому что фактически эта фраза означает: «Не хочу больше искать. Найдите за меня!» Так и хочется добавить: «Я пришел. Обслуживайте меня!»

Дополнительная информация

http://www.php.net/docs.php
Главный вход в документацию по PHP.

http://dev.mysql.com/doc/
Главный вход в документацию по My SQL. Есть возможность закачать документацию в разных форматах для локального использования. Если прокрутить страничку пониже, то можно найти ссылку на документацию на русском языке.

http://html.manual.ru/
Это не перевод скучной спецификации и не попытка написать учебник. Задача справочника – коротко и ясно описать действие всех элементов языка HTML, которые вы можете без опаски использовать при создании Internet-страниц, не боясь, что какая-то версия какого-либо браузера сделает вам неприятный сюрприз.

Иначе говоря, здесь представлен «классический» HTML, употребляемый профессиональными web-разработчиками. И ничего лишнего.

Все теги, не описанные в этом справочнике, можете смело выбросить в помойку.

http://webclass.polyn.kiae.su/konspekt.htm
Хорошие интерактивные учебники по Java Script, CSS, заголовкам HTML.

http://msdn.microsoft.com/
MSDN – официальная документация по всем продуктам microsoft, бесплатно доступная в режиме online.

Кроме всей прочей документации, здесь расположена самая полная документация по Java Script, HTML, CSS. Только для Microsoft Intenet Explorer, и в основном на английском языке.

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

Искусство поиска в Интернете. Набор ссылок.
Мнение о том, что в Интернете можно найти любую информацию, – типичный миф. Доступна, конечно, только та информация, которую кто-то потрудился разместить в Сети. Однако на практике большинство сетян не могут получить даже ту информацию, которая свободно доступна в Интернете. Горы информационного мусора скрывают нужные сведения лучше любого режима секретности.... Существующие системы поиска позволяют забраться в самые отдаленные уголки Интернета. Просто не ограничивайтесь примитивными общеупотребительными приемами – в деле поиска есть огромный простор для творчества. Поисковые службы порой позволяют буквально творить чудеса, но в полную силу используют их возможности, дай бог, несколько процентов сетевых жителей. Остальные просто не знают, как взяться за дело.

Лавренов А.Ю. Искусство поиска в Интернете
Поиск – длительный процесс. Нельзя ожидать, что необходимая информация будет найдена при составлении одного запроса. Даже если сидеть и методично перебирать результаты поиска, просматривая десятки или даже сотни сайтов, то результат не гарантирован. В языке много синонимов, поэтому смысл может быть передан разными словами. Системы искусственного интеллекта еще не созданы, и компьютер самостоятельно не в состоянии понять, чего от него хочет человек. Искусство поиска (в рамках одной поисковой машины) заключается в первую очередь в умении последовательно составлять серию запросов, анализируя информацию на каждом шаге и подстраивая запрос под поисковую машину. В статье приводится пример поиска и советы по технике поиска.

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

Автор: YuriPopoff

Раздел «ПОМОГИТЕ! Не могу там ничего найти!» из глубины веков достал SiMM
Автор раздела – tony2001