Что такое документация и для чего она нужна(простым языком)

Question

Я прохожу курс Java и не могу разобраться с этим видом комментариев.

Answer 1

Комментарии типа /** some text */ при формировании документации с помощью инструмента javadoc, будут включены в текст документации.
Обычно javadoc включает в документацию, например, описание метода и тип возвращаемого значения. Но если над методом описан такой комментарий, то он тоже будет включён в документацию.
Документация - это текстовый документ с описанием работы кода.