Re:Ask HN: Organizing company knowledge?
by itamarst on Wednesday April 11, 2018 @11:02AM
(#16811751)
If managers don't reward documentation, people won't do it. There's no magic "incentive alignment" wand, managers will either think of long term and reward maintenance work too, or will only reward shiny new work. You need topdown focus on long term sustainability of organization.
[ Parent
| on HN ]
Re:Ask HN: Organizing company knowledge?
by crdoconnor on Wednesday April 11, 2018 @11:11AM
(#16811892)
In most corporate cultures not only is documentation not rewarded, problems caused by a lack of or poor quality documentation are usually not recognized.
Re:Ask HN: Organizing company knowledge?
by virgilp on Wednesday April 11, 2018 @11:57AM
(#16812415)
It's worse than that - if you don't properly document stuff, you are that awesome guy who can help everybody. Sometimes I have the impression that some people to (semi-)intentionally create tons of already-out-of-date and misleading "documentation" to create the illusion that they did their job, but that's just the natural state of documentation is - hopelessly out-of date.