> Documentation, when it exists, is usually a band-aid covering up bad design. Pretty documentation seems like lipstick on a pig. The above two ideas are incon

> Documentation, when it exists, is usually a band-aid covering up bad design. Pretty documentation seems like lipstick on a pig. The above two ideas are incongruent, but anyway, you do realize that system design can't be self-evident for complex systems? How for example would you have no documentation for the Linux kernel? Either you're mis-communicating your point or not thinking of anything larger than tiny systems.