Document undocumented public items

Perhaps depending on #605.
I'm not sure what you mean by invalidation. I actually never saw examples of how selections are affected by DOM manipulations. Not that I can remember.