LINUX.ORG.RU
ФорумTalks

[нытик-тред]PHP лучший...

 


0

0

...документированный язык.
На мой взгляд PHP наиболее популярен среди быдлокодеров и вообще хомячков не только из-за того, что у него простой синтаксис, а в первую очередь из-за того, что у него самая лучшая онлайн документация. Нет, действительно - php.net/manual великолепен. Есть чёткое описание к каждой функции и каждому ключевому слову, на некольких языках. С примерами от разработчиком и комментариями пользователей. Я не большой любитель и стронник PHP (хотя пишу в основном на нём), но его документированность действительно замечательна.
Мне бы хотелось такой-же документированности например в С, который я сейчас изучаю. K&R конечно хорошо, но не будешь же каждый раз в ней копаться, когда что-нибудь нужно, да и не всё там есть. Всё-таки это обучающая книга, а мне нужен справочник. Да и с другими языками в большинстве своём таже песня.


>На мой взгляд PHP наиболее популярен среди быдлокодеров и вообще хомячков не только из-за того, что у него простой синтаксис, а в первую очередь из-за того, что у него самая лучшая онлайн документация.

Я себя давно уже к быдлокодерам и хомячкам не отношу, но тоже не могу не отметить лучшую и самую удобную online-документацию у PHP :)

На втором месте идёт документация у Java. Но с заметным отставанием.

KRoN73 ★★★★★
()

В «С» важно понимание того что происходит, а не набор функций и их параметров. В смысле количества функций/типов/контсрукций С более «скуден»... В то же время инструментарий невелик, но вполне достаточен для реализации почти «всего»... Главное понимание... А в КиР заглядывать особо то и нечего (посля прочтения)

Jetty ★★★★★
()
Ответ на: комментарий от iSage

cplusplus.com/fgets

Неплохо. Но длинно набирать :) И дизайн отвратительный. Ещё нет комментариев пользователей.

KRoN73 ★★★★★
()
Ответ на: комментарий от Jetty

>В «С» важно понимание того что происходит, а не набор функций и их параметров.

Как раз в плане понимания что там происходит, Си/Си++ очень простые и примитивные языки. Тот же PHP на порядки сложнее в этом смысле, так как почти всё скрыто от программиста и часто вообще невозможно знать, что внутри происходит.

А когда понимаешь, что там происходит, то приходится постоянно лазить именно в описания функций. По крайней мере так было, когда я программировал на Си/Си++ лет 15 назад. Онлайна тогда не было, так справочник по функциям Borland C++ был не просто настольной книгой, он был зачитан до дыр :)

KRoN73 ★★★★★
()
Ответ на: комментарий от Jetty

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

ArtemZ
() автор топика
Ответ на: комментарий от ArtemZ

>ключевых слов и всяких примитивов там вообще нет

Ну, это в Си, как раз, не страшно. Там всё запоминается за один вечер.

KRoN73 ★★★★★
()

>php.net/manual великолепен. Есть чёткое описание к каждой функции и каждому ключевому слову

Просто ты не видел perldoc

kranky ★★★★★
()

А какже Python? Кстати насчет документации первое место занимает ActionScript, в IDE вшиты offline версии.

Chubakur ★★
()

когда потребовалось с нулевыми знаниями пхп сделать на нём небольшой движок для онлайн-тестов - движок был готов через несколько дней и не поддавался никакому (как мне казалось по крайней мере) взлому.

jcd ★★★★★
()

> не только из-за того, что у него простой синтаксис, а в первую очередь из-за того, что у него самая лучшая онлайн документация.

Т.е. если сделать учебник «ассемблер в картинках», то все будут программить на нем?

simple_best_world_web_master
()
Ответ на: комментарий от kranky

>Просто ты не видел perldoc

Я видел. И много использовал. Это совсем не то :)

KRoN73 ★★★★★
()
Ответ на: комментарий от rainy

>в django просто образцовая документация

Она ужасна. Годится только для последовательного чтения. Найти что-то, если ты точно не знаешь, что тебе нужно - нереально. Только googlor спасал, когда у меня затыки были :)

KRoN73 ★★★★★
()
Ответ на: комментарий от Chubakur

>в IDE вшиты offline версии.

offline-версии лишены комментов. А комменты дают очень много :)

KRoN73 ★★★★★
()
Ответ на: комментарий от KRoN73

>На втором месте идёт документация у Java.

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

Mrxrrr
()
Ответ на: комментарий от Chubakur

>ActionScript, в IDE вшиты offline версии.

Жабадоки можно читать и в оффлайне в ИДЕ...

Mrxrrr
()

Довольно неплохи доки к стандартной либе питона (а у него она огромная).

PolarFox ★★★★★
()
Ответ на: комментарий от KRoN73

>> в django просто образцовая документация

Она ужасна. Годится только для последовательного чтения. Найти что-то, если ты точно не знаешь, что тебе нужно - нереально. Только googlor спасал, когда у меня затыки были :)

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

а если ты знаешь что ищешь. например описание тега, метод QS или Meta для модели, то искать это не долго.

rainy
()

бред, с доками там не всё хорошо, местами приходится лазить по комментам юзеров чтобы узнать нюансы.

Есть недокументированные фишки, тоже в каментах пишут.

В питоне относительно неплохая документация по стандартным либам, хотя и там есть пробелы.

true_admin ★★★★★
()

Покажите мне документацию для версии php, скажем, 3.1, 4.3 и 5.1? А хрен вам, не найдете. Как функция работала раньше надо придумывать самим, выковыривая из текста и плашек изменения, если о них вообще не забыли упомянуть.

Хотя быстрый поиск, да, удобный.

ntp
()
Ответ на: комментарий от TERRANZ

И да, с qtшной иде идет оффлайн версия тоже.

TERRANZ ★★★★
()

Там низкий порог вхождения. Тык-тык, копипаст и заработало. И почти во всех web-конторках используют PHP, религия какая-то. Хочешь или нет придётся его использовать. Ненавижу.

ranka-lee
()
Ответ на: комментарий от rainy

> в django просто образцовая документация

Плюсую, ничуть не хуже, чем по PHP. А питон еще и понятнее, чем тот же PHP по моему мнению.

pevzi ★★★★★
()
Ответ на: комментарий от pevzi

А еще у Qt отличная документация с сотней примеров, прямо в IDE.

pevzi ★★★★★
()
Ответ на: комментарий от ntp

> Покажите мне документацию для версии php, скажем, 3.1, 4.3 и 5.1?

зачем тебе документация по 4.3 или по 3.1? О_о
кстати, в описании функций обычно пишут, что мол deprecated since PHP 5.3 или introduced in PHP 5.2.
да, и еще -
http://www.php.net/docs.php

# You can still read a copy of the original PHP/FI 2.0 Manual on our site, which we only host for historical purposes. The same applies to the PHP 3 Manual.

isden ★★★★★
()
Ответ на: комментарий от KRoN73

>Неплохо. Но длинно набирать :)

Выкинь свой браузер, если он не позволяет решить эту проблему.

Ещё нет комментариев пользователей.

Там есть форум, по которому работает поиск. Но нюанс в том, что для PHP комментарии пользователей к документации жизненно необходимы. Потому что функции php ведут себя непредсказуемо, в них масса багов и обратная совместимость регулярно ломается. Силами одних только редакторов сайта такой бардак не разгрести (у МСДН, что характерно, те-же проблемы с теми-же решениями, только дизайн вырвижопный и поиск хромает).

legolegs ★★★★★
()

как раз хомячки документацию почти не читают ))

VladimirMalyk ★★★★★
()

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

Это позволяет: 1) Спокойно воровать чужую верстку 2) Не беспокоится о генерации структуры 3) Не напрягать мозг всякими там шаблонами DHTML, XML и прочими сложными словами 4) Не читать документацию

codoranro
()
Ответ на: комментарий от isden

> в описании функций обычно пишут, что мол deprecated since PHP 5.3 или introduced in PHP 5.2.

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

The same applies to the PHP 3 Manual.

Ага, целых 2 странички старых доков.

Для сравнения: http://www.python.org/doc/versions/

ntp
()

Документация Qt тоже на хорошем уровне, и с примерами

guilder
()
Ответ на: комментарий от JFreeM

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

Как бы себя не убеждали джава-кодеры, справка по API сгенеренная из джавадоков никогда не сможет заменить настоящей документации.

ntp
()
Ответ на: комментарий от legolegs

>Выкинь свой браузер, если он не позволяет решить эту проблему.

Я не знаю других нормальных браузеров, кроме Firefox'а, Opera или Chrome. М.б. в IE иначе?

Там есть форум, по которому работает поиск.


Это совсем-совсем не то.

Но нюанс в том, что для PHP комментарии пользователей к документации жизненно необходимы


Они жизненно необходимы в любом языке. Только в других языках обычно приходится рыться по Интернету или самому проводить эксперименты, а в PHP очень часто нужная тонкость уже бывает отражена в комментах. Или какое-то общее решение.

KRoN73 ★★★★★
()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.