Episode Details

Why is your window AC unit manual 22 pages of "don't eat the refrigerant" before it tells you how to install it? This episode unpacks the structural incentives that make most manuals terrible — asymmetric liability risk, zero economic motivation for manufacturers to help you, and legal teams optimizing for lawsuit prevention over usability. Then we explore why car manuals are the exception that proves the rule, the four principles of good technical documentation (task-oriented structure, plain language, visual hierarchy, and chunking), and five specific prompting techniques to make AI generate documentation that actually helps instead of reproducing the worst human manuals at scale. Episode #412361 — open it directly at myweirdprompts.com/412361