Oddbean new post about | logout
▲ ▼
matt | 2 months ago (raw) | root | parent | reply | flag 
 Maybe people will start doing this with the manuals they write. Some people believe that more is better in manuals when it isn't.
▲ ▼
sovereignwelder | 2 months ago (raw) | root | parent | reply | flag 
 I'm seeing more and more "quick start" sections for industrial machinery these days. 

But the corporate lawyers are always going to mandate pork to make the warranties worthless, and the engineers are going to have the noise to make themselves seem useful.
▲ ▼
matt | 2 months ago (raw) | root | parent | reply | flag 
 Yeah, some domains will always have unique issues.
▲ ▼
matt | 2 months ago (raw) | root | parent | reply | flag 
 And frankly, some manuals should contain a lot more information than others, but not unnecessary amounts of words to explain the information. That's what I have a problem with. Say what needs to be said in the fewest number of words.
▲ ▼
matt | 2 months ago (raw) | root | parent | reply | flag +1 
 Like the things I've had to read before performing certain procedures on a patient. I'm not plugging that into some AI lol I'm reading it. But every medical book or manual I've read could be improved.