В настоящее время я использую swagger с моим jax-rs приложением для документации.
Работает действительно отлично.Он собирает комментарии к документу Java и производит XML.
У меня есть одна проблема с этим.
Если я добавлю теги HTML в мой JavaDocs, Swagger просто проигнорирует это и остановится на этом.точка.
Например:
/**
*
* Service endpoint for <b>User Template</b> manipulation.
*
* @author kprakas1
*
*/
@Path(value = "/activity/templates")
Это создает документацию по пользовательскому интерфейсу Swagger следующим образом: 
Как вы можете увидеть описаниеостанавливается после TAG.
Есть ли способ решить эту проблему?Или просто перестану использовать теги HTML в моих документах Java.
Я подаю в суд Swagger 1.5