Updating docs to describe return values better