Документация для автоматизированных тестов (phpdoc/javadoc)

Кто-то использовал phpdoc/javadoc для документации автоматизированных тестов? Расскажите, что выносили в описание к тестам?

Заранее спасибо :slight_smile:

Для связки с Allure Report:
Если код написан аккуратно, то хватает Step’ов и @TmsLink на кейс в test management системе. Кому надо - из Allure отчета по этому линку перейдут почитать кейс. Я еще делал аттач к кейсу в Allure в виде html с frame, который ссылается на кейс в TM системе - удобно читать описалово кейса сразу из Allure

не забивайте лишним голову

Спасибо огромное за ответ)

Может Вы сможете мне подсказать, куда прописывать урл для TMS (точнее вот эту строку):
allure.tests.management.pattern=http://tms.yourcompany.com/tests/%s

ссылка в отчет не подтягивается((

использую allure-phpunit