我多年来一直使用Java我非常喜欢javadoc以外的语言。 由javadoc生成的文档让我觉得我在20世纪90年代浏览网页。要制作一些美容文档，你必须插入模糊的html标签，这些标签在生成html文件之前几乎不可读。
我正在为javadoc寻找一些替代方案，reStructuredText是我的第一选择，但它没有doclet。另一个选择是降价，但它主要针对html，所以如果我不能找到其他任何方式，我会将它视为我的最后手段。
我也在考虑从java文件中删除评论，但它困扰了在IDE中浏览代码的开发人员。
有什么好主意吗？