> A solution to this situation is shifting the focus from what should be written to what user needs should be addressed<p>This goes for all forms of communication, all the time. Whether you're writing or speaking or having an informal conversation, relentlessly focus on your audience: what they think, what they know, and what they need to hear.<p>Think hard about your audience, and then think about them again.<p>Oh, also my soapbox topic is all documentation should have a line at the top explaining it like you'd explain it to your parents. "This cli tool was built in order to automatically run all tests in the suite, instead of manually like before." Etc.