renaming methods and beefing up documentation