docstring, mostly to explain meanings of the two keys in the returned dictionary