Notes about changes should probably be in the git commit message, since anyone that wants that information can use `git blame`. The comment should only contain a very short summary of what the function does.