updated readme with more explanation of the returned structure