Я давно программист на Perl, но у меня всегда возникают проблемы с документацией в POD.
Когда я использую комментарии POD в коде, код трудно читать. Когда я использую комментарии POD в конце файла, существует опасность, что документация не синхронизирована с кодом.
Мне не хватает стиля документации, похожего на Java.
/**
* @description
* ...
*/
Я ищу более простую и интуитивно понятную документацию стиль. Есть ли такая вещь?