Hacker News new | ask | show | jobs
by Cthulhu_ 1466 days ago
Yeah that's the issue I have with wikis as well; there is often a big push for documenting everything initially, but then it becomes a dumping ground for things and eventually ends up unmaintained.

If you have a wiki, you need to assign a primary maintainer / editor who keeps the contents up to date. This also applies to Notion btw. And that role needs to be passed down and around.

A big issue with a lot of engineering teams is an over-eagerness to keep adding tools and processes without setting their governance in stone. It has to be done in an afternoon at most, then "thrown over the fence" for "the team" to maintain. But nothing works like that.

Don't add a tool if you're not planning on maintaining it.