adding some comments to a different version

In theory, I could have done this in the same file, but I didn't want to
force you to merge changes just yet.