Add documentation about the new closed slots logic

[pbolduc]

I previously came across the conversation that described what the closed slots logic is for. A brief comment should be added to the source code to describe the logic. More detail can be provided in a markdown document.