Я работаю над приложением, которое постоянно реорганизуется для его улучшения. Теперь, если мы переименуем определенный класс, чтобы лучше зафиксировать его намерение, вся документация, в которой упоминается класс, не обновляется автоматически, если вы не используете ссылки ({@link ClassName}) для ссылки на класс.
Однако принципы JavaDoc утверждают, что нужно "экономично использовать интерактивные ссылки", поскольку ссылки выделяются и привлекают внимание читателей, что я считаю разумным. Также вы не можете ссылаться на параметры метода.
Есть ли другой способ в JavaDoc сделать комментарии более надежными для рефакторинга, о которых я не знаю?