Everyone disagrees about Good Architecture and it changes with new technologies btw
Years ago I worked on a project that had a n tier architecture and facade pattern for the frontend
It was good architecture for the lead developer who set it up but bad for the new team who need to update the tech
So comments and docs are both valuable
Nowadays with AI the calculus has changed once more