Hacker News new | ask | show | jobs
by Cthulhu_ 953 days ago
Documentation maintenance seems underrated. For most of my career, information was dumped in a wiki, so that everyone could maintain it. But if everyone maintains it, nobody does.

Every project needs someone responsible for someone taking ownership of the documentation, including research and timestamping and the like. Have a todo list where the oldest document goes on top, check it for relevance and accuracy, cull it if it's outdated, get it up to date otherwise, and (as this comment recommends) update the timestamp.

My current project has a wiki going back years, loads of duplicate information, no clues whatsoever if it's still relevant.

1 comments

Documentation has to be part of the process. Work according to the process. Do documentation reviews.