Agreed - absolutely there is a difference between coding for academics and coding for lay people. Academics have less common sense.

However, perhaps you are overgeneralising from a few bad experiences with lay people. Indeed, younger people are far more savvy about computers than most older people, so I wonder i the demographics of computer literacy will change. Certainly in my department (neuroscience and behavioural science) it is now hard to find a student that hasn't at least dabbled in Python, and frankly, if one can understand a recipe, one can understand code. Moreover, it doesn't hurt to educate people. I think that providing multiple layers of detail - from a very general message to something a technical expert could use - allows people to choose which information they process, and everybody lives.