updating API clarity and removing comments