As discussed, we should doc comment all of these user facing methods when we are happy with the interface.