Клуб API Карт

Нужно ли расширить Справочник JavaScript API примерами?

Пост в архиве.
zh00pel
25 января 2013, 13:14
Кажется что для существующей документации API не хватает примеров, которые помогли бы быстрее понимать как использовать те или иные методы. Это можно было сделать указав больше примеров непосредственно в Справочнике или соответствующие ссылки в Песочницу.
7 комментариев

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

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

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

Думается мне что лучший способ чтоб сами пользователи и делали примеры.

Например, дать возможность в песочнице сохранять примеры пользователям.

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

А почему на внутренний?

Т.к. текст JS, наверняка хранится в какой-нибудь БД, то можно было бы реализовать такую штуку:

- Пользователи и разрабочики создают примеры в песочнице.

- на страницах с описанием каждого элемента api сделать скрипт, который бы пробегался по таблице в БД с примерами из песочницы и автоматически формировал ссылки на нужный пример в Песочнице. Так, например, свойство draggable нашел скрипт, пробежался по таблице и вывел на странице.

- скрипт пробегает по песочнице с заданным интервалом.

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

"Да, думаю это было бы удобно" т.е. если я так считаю значит я плохой программист? Думаете только плохим программистам нужны примеры? Или моё эго не может вынести что я плохой программист :-)

Спасибо. В конце дня ваш комментарий поднял настроение :))))

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