А почему им должно быть это нужно? Как вы их мотивировали?
По большей части вся эта документация в больших проектах в итоге становится каким то чатиком, зачем если на ревью можно все обсудить. И если уж нужна документация, то почему бы не написать интеграционный тест для этого (как например для своггера мы пишем)?
Как контролить качество этой документации в комментиках? Как оценивать ее актуальность? И как не тратить лишнее время на проверку её качества?
Одни лишь проблемы создаёт...