“One of the hardest problems in software engineering is getting multiple people to have a sufficient understanding of some technical aspect, like the actual problem being solved, or a proposed solution. This is ostensibly the only real goal of technical writings.”
https://surfingcomplexity.blog/2022/11/24/writing-docs-well-why-should-a-software-engineer-care/