The problem I typically have when writing about technical topics is trying to include everything and to answer objections that seem vitally important to me but which don’t make much sense unless you’ve heard the debates inside my head. Removing that stuff has by now become a standard part of my revision process. My colleagues point it out, I feel a little hurt, then I grudgingly agree, and in a week or so I re-read my work and I don’t get why I thought that extra stuff was so important in the first place.
I’ve also noticed that the parts of an argument that people object to are often the bits that I thought were almost incidental, or that exist mostly in their head — they want to keep having the argument they’ve been having before. Trying to foresee how this will play out is hard, and it always helps to have input on that.
I count myself lucky to work with people who care about this kind of thing. I wish I’d had more training in my early years of physicist school — some harried lab reports and a single term paper don’t add up to much, honestly, given how much of our professional output is the written word.