some doc strings on these methods might be helpful?