improve the documentation to describe what it is returned