Swap return values & add docstring

Function complexity prompted me to add a docstring (or whatever they're
called in languages not Python).

I was returning the non-zero value on success, whoopsie.