Crm 11915 comments

Putting notes from ticket discussion into the code. Am not sure the behaviour I saw is as described so documenting for someone looking in future.