Какие есть библиотеки для комментирования php кода и оценки покрытия кода комментариями?

Question

[Noir]

Какие есть библиотеки для комментирования php кода и оценки покрытия кода комментариями?
пример - https://www.jetbrains.com/help/phpstorm/phpdoc-com...

Comments

[sim3x]

Нет такого понятия как покрытие кода коментами

Комментарий должен обьяснять не что делается в коде, а почему код написан
Код сам должен рассказывать, что он делает

[Дмитрий]

Можно через рефлексию велосипед написать

[Дмитрий]

https://github.com/phpDocumentor/phpDocumentor2
Не оно?

[Noir]

BD_ l3ftoverZ!, sim3x, Дмитрий, мне интересно такое существует вообще, чтобы либа сама комментировала что делает код, спасибо за ответы буду искать дальше.

[sim3x]

Vitaliy,
Нет, такое никому не требуется, а за такие коменты вас будут бить всей командой вместе с уборщицой

[Максим Федоров]

Vitaliy, обычно то, что делает код описывают тесты, с библиотеками тестирваония уже идут интсрументы для подсчета покрытия (тестами)

[Noir]

Максим Федоров, если не трудно можете скинуть пример или библиотеку?

[Noir]

https://www.jetbrains.com/help/phpstorm/phpdoc-com... вот пример того что надо

[Александр Горбунов]

правильное комментирование:

/**
 * 
 */

любая нормальная IDE будет подсвечивать комментарии

Answer 1

[FanatPHP]

Это бессмысленный вопрос, и ответа на него не существует.

Чисто процент строк с комментариями можно посчитать примитивным грепом, но следйет отдавать себе отчет, что эта метрика абсолютно бессмысленная, и ничего, кроме вреда, не принесет.