Ну вот у меня есть в одном эндпоинте бизнес логика с очень сложной структурой обработки данных, вот там я пишу такой код, который сам понять через неделю не могу. Но для этого я написал доку по ней)
я работаю с семилетним легаси последние полгода
его писало порядка десятка разработчиков за это время
год назад за проект взялся один человек
он написал функцию рассчета некоторой комиссии с вложенными функциями
Жаль мне NDA не позволяет запостить сюда этот ад
Я так и не решился рефакторить этот bullshit, потому, что оно как-то работает
Но если там понадобится что-то поменять, это будет очень тяжелой задачей о простых вещах
и я очень багодарен другим разработчикам за понятный код потому, что именно благодаря этому
проект вообще можно поддерживать и менять.
"который сам понять через неделю не могу"
вот это уже тревожный звоночек, на мой взгляд
документация скорее всего не спасет когда понадобится что-то поменять
я предпочитаю не забывать про KISS