Согласен! Само документирование сложный вопрос. И описывать взаимодействие сложных модулей (возможно) не совсем правильное решение. Так как сложный модуль всегда может быть изменен, а документация нет. Банально человек забыл, а ревьювер не вспомнил. Самый правильный подход на мой взгляд - упростить код. При таком подходе будет проще поддерживать кодовую базу и читабельность будет на высоте.
Написано
Войдите на сайт
Чтобы задать вопрос и получить на него квалифицированный ответ.