Can we maybe add a doxygen doc above this to explain what this is actually doing and what the return value is saying?