There’s this frustrating vicious cycle in tech that goes:

  1. SME is bad at writing.
  2. SME has to write doco for exec.
  3. Exec gets frustrated by garbage bafflegab stream-of-consciousness nonsense and pushes back.
  4. SME assume exec is “stupid” and can’t understand “technical documents”.
  5. SME rewrites doco to read as generic anodyne boilerplate.
  6. Exec accepts document because at least it’s comprehensible.
  7. SME learns wrong freakin’ lesson.