Улучшение Документации

Ну вот к примеру у функции setOptions(). Пока Вы мне подсказали, я не понял, как конкретно эта функция может мне помочь в отключении опции draggable. Ну и документация по YMapsML на мой взгляд несколько сумбурно выглядит: на тебя вываливается куча информации, в которую приходится структурировать в голове. Вроде бы и все наглядно нарисовано, описано, но почему-то остается ощущение некого хауса. Я не знаю почему. Может это только у меня так. Про нехватку примеров - почти на каждый класс их недостаточно, как мне кажется. Взять хотя бы http://api.yandex.ru/maps/jsapi/doc/ref/reference/map.xml Думаю, что под описанием каждого метода можно сделать одну-две строчки примера его использования. Даже если и не под каждым, то хотя бы один обобщающий пример для однотипных методов: например для событий сделать один общий пример, где можно увидеть, как можно их использовать. Я знаю, что в разделе "примеры" есть примеры на эту тему. Но когда начинаешь читать документацию, о примерах забываешь. Думаю, можно поставить перекрестные ссылки со страницы описания методов и событий на данные примеры. Думаю, что начинающих разработчиков, желающих установить карту на своем сайте предостаточно, однако им просто не хватит их знаний для самостоятельного разбора документации по всем пунктам. Еще впомнил: Мне для собственной разработки был бы очень интересен пример с несколькими слоями с метками на карте, чтобы внешними кнопками их можно было бы переключать. Т.е. на одном слое стоят одни метки, а на втором - другие. И при нажатии кнопок один из них отключается, а второй включается. И, как опцию, может даже с переключением по городам по нажатию на кнопки. Я все эти функции реализовал самостоятельно, однако, мне кажется, что не каждый дойдет до этого сам. И, наверное, стоит все-таки делать примеры более приближенными к реальным реализациям на сайтах, т.е. которы можно передалать под свои нужды минимальными усилиями. Я понимаю, что все не предусмотреть, но наиболее рапространенные вещи думаю сделать стоит.

Ну не вопрос, после того как вы конкретно указали что иконки с контентом создаются с помощью шаблонов, я сразу всё понял. Информация про то как застайлить метку не совсем очевидно разнесена по подразделам. На мой взгляд нужно добавить перекрёстные ссылки. Например: (http://api.yandex.ru/maps/jsapi/doc/dg/concepts/markers_iconcontent.xml) При создании своего собственного значка вы должны сами предусмотреть возможность растягивания значки в зависимости от его содержимого. Сделать это можно с помощью "Пользовательских шаблонов" (и ссылка). Ну и было б очевидным предусмотреть возможность определить шаблоны для балунов.

Про переопределение стиля балуна - присоединяюсь. Сам решил это просто переопределением css балуна. Но это не лучший вариант.

Ну уже есть готовы примеры попроще, я не предлагаю их удалять