Sorry, I have to respectfully disagree here. My suggestion isn’t for detailed design. It’s for a simple place to put reminders of what things are for.
In an ideal world, everything would be documented and maintained. But in 20+ years of working in IT, I’ve rarely come across a project or organisation that does this properly. If it’s done at all, documentation is often seen as a maintenance overhead that’s never updated, or becomes lost in file systems. Alternatively what usually happens is it’s ignored until the wheels come off and there’s fires everywhere by which point no-one knows what’s going on and it’s a scramble to fix problems.
My suggestion, as I mentioned in an earlier reply, is the equivalent to commenting code. It might seem unnecessary to some, but it’s a godsend when you have to come back and make changes or fixes.