Главное - чтобы написанная документация соответствовала работающему решению.
Это работает на ватерфоле, когда есть госзаказ, его сделали, задокументировали, закоммитили в гит ( =))
Если же работать итеративно, неизбежно документация быстро начинает не отражать реальных изменений в программе