An Engineer’s Field Guide to Technical Writing
  • Breaking the curse, and writing effective documentation, requires empathy for your users.
  • As the person most knowledgeable about what you’ve built, you’re doomed to a calendar full of one-on-one support meetings, answering the same question from six different people. You know you could fix the problem if you had an opportunity to research and write down how things work, but you’re so busy replying to users’ questions that you never have the time.