For the most part historical notes and code changes should tracked in the commit messages instead of the code itself, but in this case it's OK.