Это где-то реально работает?) Документирование кода? Хотя комментарии к коду писать посадить хорошая идея. Может даже с ссылками на диаграмки. Странно конечно - но иногда в силу специфики работы наверное хороший вариант.
Вопрос не во времени) Вопрос - поможет ли документация получившеяся разобраться в проблеме. Как минимум текстовой документации уверен часто не достаточно, если нет диаграм как все связано и работает.
Я сколько не пробовал - на простых задачах слишком большие расходы времени, на больших и сложных - ну если ты совмещаешь работу разработчика-аналитика в одном лице то норм... Комментарии привычка писать да, полезная.
Есть требования есть код и есть тесты. Но для следуещего шага хорошо бы понимать а как именно оно сделано чтобы не придумать фичу которую больно переделывать. Ну или в следующий раз чтобы прописать нефункциональные требования или обратить внимание на бизнесовые идеи