Add mild documentation to clarify some of whats going on.