Все, как будто, ясно, красиво и очевидно, но на реализацию простейших вещей уходит уйма времени.
Что помогает:
- Наличие комментариев. JavaDoc-и есть и они довольно объемные (иногда даже информативные).
- Наличие огромного количества примеров. Имеется ввиду уже написанных плагинов, а точнее исходников к ним.
Что мешает:
- Отсутствие высокоуровневой документации. Javadoc-и это конечно хорошо, но составить общую картину по ним довольно сложно. Разбирательство c API напоминает разгадывание ребуса (с применением накопленного опыта, интуиции и русского мата).
- Довольно высокий уровень косвенности. Множество вещей (модулей и сущностей) связаны неявными правилами и эти связи проявляются только в run-time. Узнать как правильно реализовывать некоторые виды плагинов довольно проблематично: информации из javadoc-ов не достаточно и посмотреть как они(плагины) обрабатываются самой системой тоже трудно. Спасают только примеры (плагины с аналогичной функциональностью).
- Довольно большая часть информации устарела (туториалы, документация, примеры): либо ссылки битые, либо API уже изменилась. Так что, выполнение первого туториала может вылиться в довольно долгую и увлекательную задачу.
Надо как то собраться с мыслями, и записать "накопанные" знания.
