There’s this frustrating vicious cycle in tech that goes:
- SME is bad at writing.
- SME has to write doco for exec.
- Exec gets frustrated by garbage bafflegab stream-of-consciousness nonsense and pushes back.
- SME assume exec is “stupid” and can’t understand “technical documents”.
- SME rewrites doco to read as generic anodyne boilerplate.
- Exec accepts document because at least it’s comprehensible.
- SME learns wrong freakin’ lesson.