4 ms·
Documentation sucks where no one gets promoted for writing great documentation.
by josephorjoe 6y ago
Documentation sucks where no one gets promoted for writing great documentation.
- prepend 6y agoI think it’s actually negative incentive as if you document stuff, you might get questions about it. I’ve seen the “no documentation = job security” anti pattern for decades. But recently I’ve seen the “if I write something down I can be questioned better by more people so I can lay low by never describing what I’m doing how how you can reuse my libraries and methods.” It’s a weird situation where people get promoted for “doing stuff” and not for “others doing stuff with my stuff.”
- MaanuAir 6y agoI like writing good documentation. I’ve never seen any incentive for that, apart from colleagues’ thanks, which is not especially converted into promotion.