Ну потому что если что-то не понятно, то небольшой рефакторинг будет полезнее подписывания.
И если документация пишется другим способом, без автогенерации.
Да, иногда полезна, но в большинстве случаев там самые банальные вещи, иногда просто название повторяется, чтобы линтер отвязался.
Ты спросил, хорошая ли практика, тебе однозначно сказали - да.
А то, что там просто копипастят для линтера - это уже другой вопрос