Альтернатива для Джавадока?

Я использую Java в течение многих лет, мне очень нравится язык, кроме javadoc. Документ, созданный javadoc, заставляет меня чувствовать, что я просматриваю веб-страницы в 1990-х годах. Чтобы сделать какой-то косметический документ, вам нужно вставить неясные теги html, которые делают ваши комментарии почти нечитаемыми перед созданием html файла.

Я ищу альтернативу для javadoc, reStructuredText - мой первый выбор, но для него нет документа. Другим выбором является уценка, но в основном она направлена на html, поэтому я рассматриваю ее как последнее средство, если не могу понять другого пути.

Я также рассматриваю разделить комментарий от java файла, но он беспокоит разработчиков, которые просматривают код в среде IDE.

Любые хорошие идеи?

1 ответ

Возможно, вам не придется использовать альтернативу Javadoc. Если вы используете Java 7, новая версия Javadoc была переработана.

Вот пример вывода: Java 7 Reference

licensed under cc by-sa 3.0 with attribution.