Personally, it’s not that writing docs is hard—it’s the psychological, organizational, and technical hurdles in fast-paced dev cycles that push documentation to the bottom of the backlog. “We’ll do it next sprint,” we say, knowing deep down we might never get around to it.
The fix? start small.
I imagine someone has written extensively on this, but my personal process is "TDD": Test Driven Documentation. Comments and Confluence pages can grow stale. But 100% test coverage with well-explained unit tests, plus a document generator like TSDoc, helps enforce documentation matches function.
Oh, 100%.
But then, see, we are talking about a whole new topic. I love writing tests and then code, but it is not the default choice for many people.
Infact, some do coverage as a covering the branches :(
I actually mean: business requirements -> code -> tests-as-documentation. Golden path can be enforced by requiring 100% branch coverage in CICD (so every decision gets a unit test with explanation).