I'm documenting this new function, but I'm wondering if this will trigger
someone to think about whether or not this actually makes sense :)