maybe the function name and doc string for this one need to be more descriptive