improving the comments of the function