Telling the "Why" would be better to be store in Git Commit, which provides a timely comment at that time. When things change in the future, a new git comment is needed, and will never be out of sync.

Where-else code comment always risk out of sync. Someone modify the code will need to remember to change the comment. There will be no compiler error if comment and code is out of sync.