added useful docblock

Hey B,

Following up on the docblock :)