Add code comments

Someone in the future will wonder why we did this. Now they
will know.