мне кажется ключевое слово в этой фразе - Однозначно

ИМХО: контекстная справка и примеры - это всё, что должно быть off-line. И модифицироваться по мере появления удачных вариантов того и другого. Компонентная справка должна содержать ссылки на примерЫ с указанием тематик (о чём писал Galkov), в которых ЭТОТ элемент показан "во всей красе". И конечно же неплохо завести для всего этого SVN, а уж как с ним будет (и будет ли) взаимодействовать среда (или особо продвинутый юзер), это другой вопрос..