change the paramter name, add documentation