Нужно ли расширить Справочник JavaScript API примерами?
Пост в архиве.
Андрей Грэй
25 января 2013, 13:14
Кажется что для существующей документации API не хватает примеров, которые помогли бы быстрее понимать как использовать те или иные методы. Это можно было сделать указав больше примеров непосредственно в Справочнике или соответствующие ссылки в Песочницу.
да ! Удивительно, что вы задаете такие вопросы ведь и так понятно, что большинство вопросов, заданющихся в клубе не от незнания апи, а от непонимания того, как это работает, нужны реальные примеры к каждой строчке из справочника )
Вы, наверное, перепутали. Я к разрабочикам api не отношусь. Я пользователь api. Мне просто интересно мнение таких как я пользователей api. Может быть эта информация будет полезна разработчикам и доки опишут чуть более подробно.
я уже понял. просто прочитал и подумал, что разрабы интересуются. Странным еще показался вопрос ,ведь все просят больше примеров, а разработчики пока не спешат их массово делать )
Думается мне что лучший способ чтоб сами пользователи и делали примеры.
Например, дать возможность в песочнице сохранять примеры пользователям.
Таким образом объясняя друг другу кто в чем не прав, можно было бы давать пример не на внешний ресурс а на внутренний.
А почему на внутренний?
Т.к. текст JS, наверняка хранится в какой-нибудь БД, то можно было бы реализовать такую штуку:
- Пользователи и разрабочики создают примеры в песочнице.
- на страницах с описанием каждого элемента api сделать скрипт, который бы пробегался по таблице в БД с примерами из песочницы и автоматически формировал ссылки на нужный пример в Песочнице. Так, например, свойство draggable нашел скрипт, пробежался по таблице и вывел на странице.
- скрипт пробегает по песочнице с заданным интервалом.
- можно особо отметить, мол, это примеры пользователей и возможны ошибки.
"Да, думаю это было бы удобно" т.е. если я так считаю значит я плохой программист? Думаете только плохим программистам нужны примеры? Или моё эго не может вынести что я плохой программист :-)
