Ambiguity is the Enemy of Good Documentation

rogersgeorge on November 30th, 2020

The comic is funny because of the ambiguity, but if you’re not trying to be funny, don’t be ambiguous.

https://www.gocomics.com/floandfriends/2020/09/20

The solution in this case is to add labels. Tregg should have sent something like this:

IDK=I don’t know
LY=Love you
TTYL=Talk to you later

Definition, Humor Add to del.icio.us Digg This Subscribe to RSS feed

Leave a Reply

Free!

Discover five critical techniques for good writing, no charge. These are foundational to my philosophy of writing. Drop me a line at curmudgeon@writing-rag.com asking for the article, and I'll send it to you.

I don't get enough traffic to justify using an auto-responder, so you'll get the article directly from me.

I happen to have another article with some good tips. I'll send you both.

Bio

Rogers George has been a technical writer for more than 20 years. He has written on subjects as diverse as outhouse assembly, restaurant reviews, software, information security, and scientific equipment. He has his own writing consultancy and is always happy to discuss writing and grammar. Drop him a line at curmudgeon@writing-rag.com.

Meta

Tags