Added delete failure docs

This is a more complex behaviour that certainly needs documenting.