update doc to reflect code changes - moving to an options hash