Mastodon - 2024-05-30T02:24:39Z

Mastodon

Know your audience & don’t bury the lead.

“Zooming out a bit, this is a classic “lack of user empathy” problem. Folks authoring the document are so deep in the details that they can’t put themselves in the readers’ mindset to think about how overwhelming the document would be if you were simply trying to pop in, get an answer, and then pop out.”

lethain.com/readable-engineeri

Mastodon Source 🐘