skinny.

Latest / Logosofia no Dia a Dia

Why Manuals Are Terrible (And How AI Can Fix Them)

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…

The skinny

The skinny isn't ready yet — notes appear once the transcript is processed.