Why isn't this a feature of documentation frameworks? Like it could be just a simple, "Hey, I see this function in the codebase has changed since the time you wrote the documemtation for it, do you want to update it's description?"
I would definitely be at danger of getting into the habit of just saying no if I was asked everytime it changed, especially early in the dev cycle. However, if it was just at pull request time, I probably wouldn't get frustrated with it.
Slightly OT, but what documentation frameworks do you recommend?