Народ, а подскажите, плиз, в какую сторону надо копать. Мы делаем некоторый компонент для отображения данных, но что представляет собой источник данных, мы обсолютно не знаем, просто выставляем API, которому должны удовлетворять сервис провайдеры. Вот собственно хочется задокументировать наш API, и способы как можно реализовать сервис провайдеры. Примеры реализации сервис провайдеров тащить в JavaDoc, вообще не хочется, хотелось бы просто через Markdown описать, собрать в статику и запаблишить вместе с каким нибудь примером на сервер в виде варки. Позволит ли maven site такое провернуть? или может какой-то другой тул посоветуете?