Good multiline comment!  Tells what the function is doing and what the return value will be.  Exactly the kind of information you'd want in the doc string up top.