Где разместить тег @since в файле kotlin без класса?

Question

Обычно мы помещаем теги @author и @since в аннотацию javadoc/kdoc для класса верхнего уровня.

Но если файл kotlin не имеет никакого класса или объекта, вместо функций верхнего уровня, есть ли хорошая позиция для размещения тегов @author и @since?

Answer 1

Как уже упоминалось здесь , вы можете поместить их в элементы функций верхнего уровня. Однако если вы хотите документировать модули / пакеты, вам нужно создать отдельный файл уценки. Обратитесь к последнему разделу связанной страницы документации.