I'd reformat this doc string a bit so you use `:returns:` to describe what exactly you're expecting to return.  It should make it a little easier to read.