|
|
|
|
|
by groby_b
902 days ago
|
|
People care. At the individual level. In the abstract. But there are two obstacles that keep them from doing the right thing. One is that without discoverability of those docs (in a non-legal sense ;) it's a doomed effort, because ... there are too many docs. Even if everything is woefully underdocumented, it's still too much to just find the right thing. (There are simultaneously too few docs in most orgs, so the corpus you could train search on is too small to be truly impactful for any ML solution). The second missing part is a set of clear expectations that folks do this, and rewards if it's done exceptionally well. Or, really, a culture around document, though these two are the skeleton you hang a culture off. And if that culture doesn't exist, most people will not write docs - the org is sending a clear signal it doesn't value them, and it takes a lot of effort to do things you know won't be rewarded or valued. The second one looks like people don't care. But really, it's leadership sending a clear signal of "Please don't care, this is not important to us". |
|