Недавно я добавил некоторые выходные данные javadoc в систему контроля версий (поскольку github отображает содержимое ветви gh_pages как веб-сайт, это был самый простой способ разместить их в Интернете ).
Одна из проблем здесь заключается в том, что javadoc вставляет в каждый файл дату / время запуска javadoc, поэтому у вас всегда есть изменения всех ваших файлов с одного коммита на следующий. Поэтому не ожидайте, что у вас будет полезный diff, который покажет вам, какая документация действительно изменилась между вашими версиями, если вам не удастся каким-то образом игнорировать эти строки комментариев при дифференцировании.
(На самом деле, из-за другого вопроса я узнал, как опустить метку времени.)
И, конечно, вы всегда должны иметь возможность восстановить свой Javadoc из проверки старых источников. А для выпущенных библиотек опубликуйте вместе с ним javadoc выпущенной версии.
Для сторонних библиотек, которые вы используете внутри своего проекта в качестве jar-файлов (или всего, что вы сами не компилируете), может быть полезно сохранить javadoc, соответствующий версии, используемой внутри дерева исходных текстов (и, таким образом, версированный тоже) хотя. (При использовании Maven вы обычно можете скачать javadoc jar вместе с работающим jar библиотеки, поэтому он не применяется.)