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?"

Slightly OT, but what documentation frameworks do you recommend?

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.

I'm actually building this very thing—shoot me an email at govind <dot> gnanakumar <at> outlook <dot> com if you'd like to be a beta tester.