> Wow, almost sounds like some other aspect of a job a software engineer is required to do... Which I think is the real problem. Writing/modifying code can't b

> Wow, almost sounds like some other aspect of a job a software engineer is required to do... Which I think is the real problem. Writing/modifying code can't be ignored; the resulting behavior of technical systems absolutely depends on doing that. You can argue that the desired behavior of human system also depends on good writing and you're correct. But the connection of the input and output is much more opaque, the social conception of the role is focused on the behavior of technical systems, the incentive structures are therefore focused on the behavior of technical systems, so when there is more to do than can be done writing docs will not make the top of the priority queue.