IMO unless there is some technical writer around there, which job is to put that doco right - extract the info from people heads, combine it and word it properl

IMO unless there is some technical writer around there, which job is to put that doco right - extract the info from people heads, combine it and word it properly.. it's not happening. For 30+ years only few times i have not been the lonely editor of the project wiki (or whatever knowledge-base).. and i dont like doing it either.. but have to, as it's worse otherwise. Writing (succint, correct, tautological where needed and non-dubious all-over) text is very hard, and very very different to coding, or any math-like thinking. Because the human language allows to do anything with it. (Esp. if foreign language, that adds another dimension to what that anything means). It needs (skill and) different frame of mind, and switching to and from isn't easy. Which is probably main unspoken reason why developers avoid it (most techincal people actualy, mechanical engineers also dont really like writing documentation) - apart of other usual reasons, like lack of time, whatever..