Document record directionality option

Adds documentation to the record method.  @benlangfeld double-check this for me?