Wish we had an example of input args and their expected output documentation on this function.