Since there are three different methods that have "deleted" in their names, I think it is worth commenting all three to explain when they are called and how they differ from each other.