Комментарии в java похожи на заметки в реальной жизни, которые используются для отображения некоторой информации, которую другие программисты или разработчики могут читать и понимать.
Хорошая практика - добавлять комментарии к вашему коду, особенно при работе с командой или в компании. Это помогает будущим разработчикам или товарищам по команде легче понять, что происходит в вашем коде. Комментарии делают ваш код более аккуратным и организованным.
Комментарий к документации используется инструментом Javadoc для создания документации для кода. Комментарий документации используется разработчиками для документирования кода, например, что какие функции выполняет класс или что делает метод. Это используется инструментом javadoc, который будет компилировать предварительно отформатированный набор html-файлов, содержащих всю информацию, доступную в комментарии.