Clarity over completeness

It is natural to want to be complete when communicating your work. You understand, better than anyone else, the kinds of assumptions and caveats that go into the results. They shouldn’t be taken at face value and, more importantly, there are eleven edge cases that you thought of.

However, communication isn’t about you. Instead, it is entirely about the receiver and how what you write or say fits in their context. There is the rare situation when their context demands all the assumptions, caveats and edge cases.

But, for everyone else, we need to focus on clarity over completeness.

If the purpose of our communication is to bring them along or tell our story (and it generally is that), it needs to start with clarity.

(H/T to the wiser friend who gave me this advice)