“It is the responsibility of all programmers to communicate effectively with their colleagues (and their future self). Even if the business doesn’t ask you to communicate, or actively discourages you from taking the time to communicate, programmers have a duty of care to communicate.”
https://tidyfirst.substack.com/p/the-documentation-tradeoff