Fixed the documentation. I get what you're saying about the return tuple order, but a namedtuple seems like it might be overkill since there's only ever two things and the order is pretty intuitive (important thing you care about, much less important thing you might care about).