adding documenation for rates method