documenting the arguments to the functions