В кодовой базе, которая документирована в JavaDoc в настоящее время, мы хотели бы перейти к документации на основе Markdown.
Существуют доклеты для анализа комментариев документации Markdown.
Однако невозможно переписать все комментарии к документу в корпоративном проекте сразу.
Есть ли способ начать и конвертировать один комментарий к документу за раз и при этом получить совокупную документацию API? (Я полагаю, что если он есть, он будет работать через аннотацию или тег строки документа, который действует как переключатель между используемыми документами).
Если такой существует, какова конфигурация maven?
Потенциально связанные вопросы: