Hacker News new | ask | show | jobs
by andrekandre 2166 days ago
documentation has to be actively maintained, but even old and innacurate documentation can serve as a starting point (and be update to be accurate) when something needs to be investigated/refactored etc

without any documentation, all you have is word of mouth, and when people quit, the organizations knowledge DECREASES over time

> people waste time on writing documents that just sit there unread. No one wants to RTFM

documentation is hard... most documents that i have seen are mostly brain dumps, very badly formatted, just very hard to follow...

one thing i think severely missing in school and otj training is how to write documents people WANT to read