Hacker News new | ask | show | jobs
by josephorjoe 1932 days ago
Documentation sucks where no one gets promoted for writing great documentation.
2 comments

I 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.”

I like writing good documentation.

I’ve never seen any incentive for that, apart from colleagues’ thanks, which is not especially converted into promotion.